ClientWebSocket.ConnectAsync Metodo

Definizione

Spazio dei nomi:

System.Net.WebSockets

Assembly:

System.Net.WebSockets.Client.dll

Overload

ConnectAsync(Uri, CancellationToken)	Connette a un server WebSocket come operazione asincrona.
ConnectAsync(Uri, HttpMessageInvoker, CancellationToken)	Connette a un server WebSocket come operazione asincrona.

ConnectAsync(Uri, CancellationToken)

Origine:

ClientWebSocket.cs

Connette a un server WebSocket come operazione asincrona.

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

Public Function ConnectAsync (uri As Uri, cancellationToken As CancellationToken) As Task

Parametri

uri

Uri

URI del server WebSocket con cui stabilire la connessione.

cancellationToken

CancellationToken

Token di annullamento usato per propagare la notifica che l'operazione deve essere annullata.

Restituisce

Task

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Il ConnectAsync metodo avvia l'handshake WebSocket con una destinazione di rete remota e quindi negozia il protocollo secondario.

Per le connessioni WebSocket semplici, usare lo ws:// schema nell'URI. Per le connessioni WebSocket sicure tramite TLS/SSL, usare lo wss:// schema .

Questa operazione non verrà bloccata. L'oggetto restituito Task verrà completato al termine della richiesta di connessione nell'istanza ClientWebSocket .

La richiesta handshake WebSocket include intestazioni predefinite per la richiesta HTTP/1.1:

Connection: Upgrade

Upgrade: websocket

Sec-WebSocket-Key: [generated key]

Per la richiesta HTTP/2:

:protocol: websocket

Per impostazione predefinita, verrà usato HTTP/1.1. Per modificare la versione HTTP usata o abilitare l'aggiornamento/downgrade della versione HTTP, vedere HttpVersion opzione e HttpVersionPolicy opzione.

ConnectAsync(Uri, HttpMessageInvoker, CancellationToken)

Origine:

ClientWebSocket.cs

Connette a un server WebSocket come operazione asincrona.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(Uri ^ uri, System::Net::Http::HttpMessageInvoker ^ invoker, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task ConnectAsync (Uri uri, System.Net.Http.HttpMessageInvoker? invoker, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : Uri * System.Net.Http.HttpMessageInvoker * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function ConnectAsync (uri As Uri, invoker As HttpMessageInvoker, cancellationToken As CancellationToken) As Task

Parametri

uri

Uri

URI del server WebSocket con cui stabilire la connessione.

invoker

HttpMessageInvoker

HttpMessageInvoker Istanza da utilizzare per la connessione.

cancellationToken

CancellationToken

Token di annullamento usato per propagare la notifica che l'operazione deve essere annullata.

Restituisce

Task

Oggetto dell'attività che rappresenta l'operazione asincrona.

Eccezioni

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.