MessageWebSocket.Control Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 MessageWebSocketControlValeur de propriété
Données de contrôle de socket sur un objet MessageWebSocket .
Remarques
La propriété Control obtient l’instance MessageWebSocketControl associée à un objet MessageWebSocket .
Un objet MessageWebSocketControl est créé automatiquement avec l’objet MessageWebSocket parent. L’instance MessageWebSocketControl peut ensuite être utilisée pour obtenir ou définir des données de contrôle utilisées par l’objet MessageWebSocket . Ces propriétés sur l’instance MessageWebSocketControl sont les suivantes :
- MaxMessageSize : taille maximale du message, en octets, pour qu’un message WebSocket soit configuré 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 l’envoi de 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 à d’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 le MessageWebSocket.