ClientWebSocket.ConnectAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.WebSockets

Zestaw:

System.Net.WebSockets.Client.dll

Przeciążenia

ConnectAsync(Uri, CancellationToken)	Nawiązuje połączenie z serwerem WebSocket jako operacją asynchroniczną.
ConnectAsync(Uri, HttpMessageInvoker, CancellationToken)	Nawiązuje połączenie z serwerem WebSocket jako operacją asynchroniczną.

ConnectAsync(Uri, CancellationToken)

Źródło:

ClientWebSocket.cs

Nawiązuje połączenie z serwerem WebSocket jako operacją asynchroniczną.

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

Identyfikator URI serwera WebSocket do nawiązania połączenia.

cancellationToken

CancellationToken

Token anulowania używany do propagacji powiadomienia, że operacja powinna zostać anulowana.

Zwraca

Task

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Metoda ConnectAsync inicjuje uzgadnianie protokołu WebSocket z lokalizacją docelową sieci zdalnej, a następnie negocjuje pod protokół.

W przypadku zwykłych połączeń protokołu WebSocket użyj ws:// schematu w identyfikatorze URI. W przypadku bezpiecznych połączeń protokołu WebSocket za pośrednictwem protokołu TLS/SSL użyj schematu wss:// .

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task po zakończeniu żądania połączenia w wystąpieniu ClientWebSocket .

Żądanie uzgadniania protokołu WebSocket ma domyślne nagłówki dla żądania HTTP/1.1:

Connection: Upgrade

Upgrade: websocket

Sec-WebSocket-Key: [generated key]

W przypadku żądania HTTP/2:

:protocol: websocket

Domyślnie będzie używany protokół HTTP/1.1. Aby zmienić wersję protokołu HTTP używaną lub włączyć uaktualnienie/obniżenie wersji PROTOKOŁU HTTP, zobacz HttpVersion opcję i HttpVersionPolicy opcję.

ConnectAsync(Uri, HttpMessageInvoker, CancellationToken)

Źródło:

ClientWebSocket.cs

Nawiązuje połączenie z serwerem WebSocket jako operacją asynchroniczną.

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

Identyfikator URI serwera WebSocket do nawiązania połączenia.

invoker

HttpMessageInvoker

Wystąpienie HttpMessageInvoker do użycia do nawiązywania połączenia.

cancellationToken

CancellationToken

Token anulowania używany do propagacji powiadomienia, że operacja powinna zostać anulowana.

Zwraca

Task

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.