ClientWebSocket.ConnectAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| ConnectAsync(Uri, CancellationToken) |
Se connecte à un serveur WebSocket en tant qu’opération asynchrone. |
| ConnectAsync(Uri, HttpMessageInvoker, CancellationToken) |
Se connecte à un serveur WebSocket en tant qu’opération asynchrone. |
ConnectAsync(Uri, CancellationToken)
- Source:
- ClientWebSocket.cs
- Source:
- ClientWebSocket.cs
- Source:
- ClientWebSocket.cs
Se connecte à un serveur WebSocket en tant qu’opération asynchrone.
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.TaskPublic Function ConnectAsync (uri As Uri, cancellationToken As CancellationToken) As TaskParamètres
- uri
- Uri
URI du serveur WebSocket auquel se connecter.
- cancellationToken
- CancellationToken
Jeton d’annulation utilisé pour propager la notification indiquant que l’opération doit être annulée.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
Remarques
La ConnectAsync méthode lance l’établissement d’une liaison WebSocket avec une destination réseau distante, puis négocie le sous-protocole.
Pour les connexions WebSocket simples, utilisez le ws:// schéma dans l’URI. Pour sécuriser les connexions WebSocket via TLS/SSL, utilisez le wss:// schéma .
Cette opération ne se bloque pas. L’objet retourné Task se termine une fois la demande de connexion sur le ClientWebSocket instance terminée.
La requête de négociation WebSocket a des en-têtes par défaut pour la requête HTTP/1.1 :
Connection: Upgrade
Upgrade: websocket
Sec-WebSocket-Key: [generated key]
Pour la requête HTTP/2 :
:protocol: websocket
Par défaut, HTTP/1.1 est utilisé. Pour modifier la version HTTP utilisée ou activer la mise à niveau/rétrogradation de version HTTP, consultez HttpVersion l’option et HttpVersionPolicy l’option .
S’applique à
ConnectAsync(Uri, HttpMessageInvoker, CancellationToken)
- Source:
- ClientWebSocket.cs
- Source:
- ClientWebSocket.cs
- Source:
- ClientWebSocket.cs
Se connecte à un serveur WebSocket en tant qu’opération asynchrone.
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.TaskPublic Function ConnectAsync (uri As Uri, invoker As HttpMessageInvoker, cancellationToken As CancellationToken) As TaskParamètres
- uri
- Uri
URI du serveur WebSocket auquel se connecter.
- invoker
- HttpMessageInvoker
Instance HttpMessageInvoker à utiliser pour la connexion.
- cancellationToken
- CancellationToken
Jeton d’annulation utilisé pour propager la notification indiquant que l’opération doit être annulée.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
