Idioma

MessageWebSocket.Control Propriedade

Definição

Namespace:
Windows.Networking.Sockets
Editar

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 MessageWebSocketControl

Valor da propriedade

MessageWebSocketControl

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 subconjuntos 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 o MessageWebSocket esteja conectado. Definir essa propriedade depois que o MessageWebSocket estiver conectado não tem efeito.

As alterações em quaisquer outros valores de propriedade no MessageWebSocketControl devem ser definidas antes que o MessageWebSocket esteja 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.

Aplica-se a

Confira também