ClientWebSocket.ConnectAsync(Uri, CancellationToken) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Подключается к серверу WebSocket в качестве асинхронной операции.
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 TaskПараметры
- uri
- Uri
URI сервера WebSocket для подключения.
- cancellationToken
- CancellationToken
Маркер отмены, используемый для распространения уведомлений о том, что операция должна быть отменена.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Комментарии
Метод ConnectAsync инициирует подтверждение WebSocket с удаленным назначением сети, а затем согласовывает вложенный протокол.
Для обычных подключений WebSocket используйте схему ws:// в URI. Для безопасных подключений WebSocket по протоколу TLS/SSL используйте схему wss:// .
Эта операция не блокируется. Возвращенный Task объект завершится после завершения запроса подключения к экземпляру ClientWebSocket .
Запрос подтверждения WebSocket имеет заголовки по умолчанию для запроса HTTP/1.1:
Connection: Upgrade
Upgrade: websocket
Sec-WebSocket-Key: [generated key]
Для запроса HTTP/2:
:protocol: websocket
По умолчанию будет использоваться HTTP/1.1. Чтобы изменить используемую версию HTTP или включить обновление и понижение версии HTTP, см HttpVersion . параметр и HttpVersionPolicy параметр.