ClientWebSocket.ConnectAsync Metoda

Definice

Obor názvů:

System.Net.WebSockets

Sestavení:

System.Net.WebSockets.Client.dll

Přetížení

ConnectAsync(Uri, CancellationToken)	Připojí se k serveru WebSocket jako asynchronní operace.
ConnectAsync(Uri, HttpMessageInvoker, CancellationToken)	Připojí se k serveru WebSocket jako asynchronní operace.

ConnectAsync(Uri, CancellationToken)

Zdroj:

ClientWebSocket.cs

Připojí se k serveru WebSocket jako asynchronní operace.

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

Parametry

uri

Uri

Identifikátor URI serveru WebSocket, ke kterému se má připojit.

cancellationToken

CancellationToken

Token zrušení použitý k rozšíření oznámení, že operace by měla být zrušena.

Návraty

Task

Objekt úlohy představující asynchronní operaci.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Metoda ConnectAsync zahájí metodu handshake protokolu WebSocket se vzdáleným cílem sítě a pak vyjedná dílčí protokol.

U prostých připojení WebSocket použijte ws:// schéma v identifikátoru URI. Pro zabezpečená připojení WebSocket přes TLS/SSL použijte wss:// schéma .

Tato operace nebude blokována. Task Vrácený objekt se dokončí po dokončení žádosti o připojení v ClientWebSocket instanci.

Požadavek metody handshake protokolu WebSocket má výchozí hlavičky pro požadavek HTTP/1.1:

Connection: Upgrade

Upgrade: websocket

Sec-WebSocket-Key: [generated key]

Pro požadavek HTTP/2:

:protocol: websocket

Ve výchozím nastavení se použije HTTP/1.1. Pokud chcete změnit použitou verzi HTTP nebo povolit upgrade nebo downgrade verze HTTP, projděte si téma HttpVersion možnosti a HttpVersionPolicy možnosti.

ConnectAsync(Uri, HttpMessageInvoker, CancellationToken)

Zdroj:

ClientWebSocket.cs

Připojí se k serveru WebSocket jako asynchronní operace.

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

Parametry

uri

Uri

Identifikátor URI serveru WebSocket, ke kterému se má připojit.

invoker

HttpMessageInvoker

Instance HttpMessageInvoker , která se má použít pro připojení.

cancellationToken

CancellationToken

Token zrušení použitý k rozšíření oznámení, že operace by měla být zrušena.

Návraty

Task

Objekt úlohy představující asynchronní operaci.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.