MessageWebSocket.Control Propriété

Définition

Espace de noms:

Windows.Networking.Sockets

Obtient les données de contrôle de socket sur un objet MessageWebSocket .

public:
 property MessageWebSocketControl ^ Control { MessageWebSocketControl ^ get(); };

MessageWebSocketControl Control();

public MessageWebSocketControl Control { get; }

var messageWebSocketControl = messageWebSocket.control;

Public ReadOnly Property Control As MessageWebSocketControl

Valeur de propriété

MessageWebSocketControl

Données de contrôle de socket sur un objet MessageWebSocket .

Remarques

La propriété Control obtient les instance MessageWebSocketControl associés à un objet MessageWebSocket.

Un objet MessageWebSocketControl est créé automatiquement avec l’objet Parent MessageWebSocket . Le instance MessageWebSocketControl peut ensuite être utilisé pour obtenir ou définir les données de contrôle utilisées par l’objet MessageWebSocket. Ces propriétés sur l’instance MessageWebSocketControl incluent les éléments suivants :

• MaxMessageSize : taille de message maximale, en octets, pour un message WebSocket à configurer sur l’objet MessageWebSocket .
• MessageType : type de message WebSocket à configurer sur un objet MessageWebSocket pour les opérations d’écriture.
• OutboundBufferSizeInBytes : taille, en octets, de la mémoire tampon d’envoi à utiliser pour envoyer des données sur un objet MessageWebSocket .
• ProxyCredential : informations d’identification à utiliser pour s’authentifier auprès du serveur proxy via l’authentification d’en-tête HTTP à l’aide d’un objet MessageWebSocket .
• ServerCredential : informations d’identification à utiliser pour s’authentifier auprès du serveur WebSocket via l’authentification d’en-tête HTTP à l’aide d’un objet MessageWebSocket .
• SupportedProtocols : obtient une collection qui peut être utilisée pour ajouter une liste de sous-protocoles pris en charge qui seront publiés sur le serveur pendant la négociation de connexion.

La propriété SupportedProtocols obtient la valeur de cette propriété et peut être appelée à tout moment.

La propriété MessageType peut être modifiée à tout moment avant ou après la connexion de MessageWebSocket . Cela permet à une application de basculer entre les messages binaires et UTF-8 si nécessaire.

La propriété OutboundBufferSizeInBytes doit être définie avant la connexion de MessageWebSocket . La définition de cette propriété après la connexion de MessageWebSocket n’a aucun effet.

Les modifications apportées aux autres valeurs de propriété sur MessageWebSocketControl doivent être définies avant la connexion de MessageWebSocket . Par conséquent, si vous devez apporter des modifications aux propriétés MaxMessageSize, OutboundBufferSizeInBytes, ProxyCredential ou ServerCredential , ces modifications doivent se produire avant un appel réussi à la méthode ConnectAsync sur messageWebSocket.

Voir aussi

• MaxMessageSize
• MessageType
• MessageWebSocketControl
• OutboundBufferSizeInBytes
• ProxyCredential
• SupportedProtocols
• Comment utiliser des contrôles WebSocket avancés