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 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.