ClientWebSocket.ConnectAsync Metodo

Definizione

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
Origine:
ClientWebSocket.cs
Origine:
ClientWebSocket.cs

Connette a un server WebSocket come operazione asincrona.

public System.Threading.Tasks.Task ConnectAsync (Uri uri, System.Threading.CancellationToken cancellationToken);

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

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

Eccezioni

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.

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

ConnectAsync(Uri, HttpMessageInvoker, CancellationToken)

Origine:
ClientWebSocket.cs
Origine:
ClientWebSocket.cs
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);

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

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

Eccezioni

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

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET 7, 8, 9