ClientWebSocket.ConnectAsync(Uri, CancellationToken) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Maakt verbinding met een WebSocket-server als asynchrone bewerking.
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 TaskParameters
- uri
- Uri
De URI van de WebSocket-server waarmee verbinding moet worden gemaakt.
- cancellationToken
- CancellationToken
Een annuleringstoken dat wordt gebruikt om een melding door te geven dat de bewerking moet worden geannuleerd.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
De ConnectAsync methode initieert de WebSocket-handshake met een extern netwerkdoel en onderhandelt vervolgens over het subprotocol.
Gebruik het ws:// schema in de URI voor gewone WebSocket-verbindingen. Gebruik het wss:// schema voor beveiligde WebSocket-verbindingen via TLS/SSL.
Deze bewerking wordt niet geblokkeerd. Het geretourneerde Task object wordt voltooid nadat de verbindingsaanvraag op het ClientWebSocket exemplaar is voltooid.
De WebSocket handshake-aanvraag bevat standaardheaders voor HTTP/1.1-aanvragen:
Connection: Upgrade
Upgrade: websocket
Sec-WebSocket-Key: [generated key]
Voor HTTP/2-aanvraag:
:protocol: websocket
HTTP/1.1 wordt standaard gebruikt. Zie HttpVersion de optie en HttpVersionPolicy optie om de gebruikte HTTP-versie te wijzigen of http-versie te upgraden/downgraden in te schakelen.