ClientWebSocket.ConnectAsync(Uri, CancellationToken) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Liga-se a um servidor WebSocket como uma operação assíncrona.
public:
System::Threading::Tasks::Task ^ ConnectAsync(Uri ^ uri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task ConnectAsync(Uri uri, System.Threading.CancellationToken cancellationToken);member this.ConnectAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function ConnectAsync (uri As Uri, cancellationToken As CancellationToken) As TaskParâmetros
- uri
- Uri
O URI do servidor WebSocket para ligar.
- cancellationToken
- CancellationToken
Um token de cancelamento é usado para propagar a notificação de que a operação deve ser cancelada.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
O ConnectAsync método inicia o handshake WebSocket com um destino remoto de rede e depois negocia o subprotocolo.
Para ligações WebSocket simples, use o ws:// esquema no uri. Para ligações WebSocket seguras via TLS/SSL, use o wss:// esquema.
Esta operação não vai bloquear. O objeto devolvido Task será concluído depois de o pedido de ligação na ClientWebSocket instância estar concluído.
O pedido de handshake WebSocket tem cabeçalhos predefinidos para o pedido HTTP/1.1:
Connection: Upgrade
Upgrade: websocket
Sec-WebSocket-Key: [generated key]
Para pedido HTTP/2:
:protocol: websocket
Por defeito, será usado o HTTP/1.1. Para alterar a versão HTTP usada ou ativar a atualização/downgrade da versão HTTP, consulte HttpVersion opção e HttpVersionPolicy opção.