ClientWebSocket.ConnectAsync Metode

Definisi

Ruang nama:

System.Net.WebSockets

Rakitan:

System.Net.WebSockets.Client.dll

Overload

ConnectAsync(Uri, CancellationToken)	Menyambungkan ke server WebSocket sebagai operasi asinkron.
ConnectAsync(Uri, HttpMessageInvoker, CancellationToken)	Menyambungkan ke server WebSocket sebagai operasi asinkron.

ConnectAsync(Uri, CancellationToken)

Sumber:

ClientWebSocket.cs

Menyambungkan ke server WebSocket sebagai operasi asinkron.

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

Parameter

uri

Uri

URI server WebSocket untuk disambungkan.

cancellationToken

CancellationToken

Token pembatalan yang digunakan untuk menyebarluaskan pemberitahuan bahwa operasi harus dibatalkan.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Metode ConnectAsync ini memulai jabat tangan WebSocket dengan tujuan jaringan jarak jauh, lalu menegosiasikan sub-protokol.

Untuk koneksi WebSocket biasa, gunakan ws:// skema di uri. Untuk koneksi WebSocket yang aman melalui TLS/SSL, gunakan wss:// skema .

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task akan selesai setelah permintaan sambungkan ClientWebSocket pada instans selesai.

Permintaan jabat tangan WebSocket memiliki header default untuk permintaan HTTP/1.1:

Connection: Upgrade

Upgrade: websocket

Sec-WebSocket-Key: [generated key]

Untuk permintaan HTTP/2:

:protocol: websocket

Secara default, HTTP/1.1 akan digunakan. Untuk mengubah versi HTTP yang digunakan atau mengaktifkan peningkatan/penurunan versi HTTP, lihat HttpVersion opsi dan HttpVersionPolicy opsi.

ConnectAsync(Uri, HttpMessageInvoker, CancellationToken)

Sumber:

ClientWebSocket.cs

Menyambungkan ke server WebSocket sebagai operasi asinkron.

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

Parameter

uri

Uri

URI server WebSocket untuk disambungkan.

invoker

HttpMessageInvoker

Instans HttpMessageInvoker yang digunakan untuk menyambungkan.

cancellationToken

CancellationToken

Token pembatalan yang digunakan untuk menyebarluaskan pemberitahuan bahwa operasi harus dibatalkan.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.