MessageWebSocket.Control Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém dados de controle de soquete em um objeto MessageWebSocket .
public:
property MessageWebSocketControl ^ Control { MessageWebSocketControl ^ get(); };MessageWebSocketControl Control();public MessageWebSocketControl Control { get; }var messageWebSocketControl = messageWebSocket.control;Public ReadOnly Property Control As MessageWebSocketControlValor da propriedade
Dados de controle de soquete em um objeto MessageWebSocket .
Comentários
A propriedade Control obtém a instância MessageWebSocketControl associada a um objeto MessageWebSocket .
Um objeto MessageWebSocketControl é criado automaticamente com o objeto MessageWebSocket pai. A instância MessageWebSocketControl pode ser usada para obter ou definir dados de controle usados pelo objeto MessageWebSocket . Essas propriedades na instância MessageWebSocketControl incluem o seguinte:
- MaxMessageSize - O tamanho máximo da mensagem, em bytes, para que uma mensagem WebSocket seja configurada no objeto MessageWebSocket .
- MessageType – o tipo de mensagem WebSocket a ser configurado em um objeto MessageWebSocket para operações de gravação.
- OutboundBufferSizeInBytes - O tamanho, em bytes, do buffer de envio a ser usado para enviar dados em um objeto MessageWebSocket .
- ProxyCredential – a credencial a ser usada para autenticar no servidor proxy por meio da autenticação de cabeçalho HTTP usando um objeto MessageWebSocket .
- ServerCredential – a credencial a ser usada para autenticar no servidor WebSocket por meio da autenticação de cabeçalho HTTP usando um objeto MessageWebSocket .
- SupportedProtocols – obtém uma coleção que pode ser usada para adicionar uma lista de subpro protocolos com suporte que serão anunciados ao servidor durante o handshake de conexão.
A propriedade SupportedProtocols obtém o valor dessa propriedade e pode ser chamada a qualquer momento.
A propriedade MessageType pode ser alterada a qualquer momento antes ou depois que o MessageWebSocket estiver conectado. Isso permite que um aplicativo alterne entre mensagens binárias e UTF-8 quando necessário.
A propriedade OutboundBufferSizeInBytes deve ser definida antes que MessageWebSocket esteja conectado. Definir essa propriedade depois que MessageWebSocket estiver conectado não terá efeito.
As alterações em quaisquer outros valores de propriedade no MessageWebSocketControl devem ser definidas antes que o MessageWebSocket seja conectado. Como resultado, se você precisar fazer alterações nas propriedades MaxMessageSize, OutboundBufferSizeInBytes, ProxyCredential ou ServerCredential , essas alterações deverão ocorrer antes de uma chamada bem-sucedida para o método ConnectAsync no MessageWebSocket.