ClientWebSocket.SendAsync Метод

Определение

Пространство имен:

System.Net.WebSockets

Сборка:

System.Net.WebSockets.Client.dll

Перегрузки

SendAsync(ArraySegment<Byte>, WebSocketMessageType, Boolean, CancellationToken)	Отправляет данные по ClientWebSocket в асинхронной операции.
SendAsync(ReadOnlyMemory<Byte>, WebSocketMessageType, Boolean, CancellationToken)	Отправляет данные по ClientWebSocket из диапазона памяти байтов, доступного только для чтения, в асинхронной операции.
SendAsync(ReadOnlyMemory<Byte>, WebSocketMessageType, WebSocketMessageFlags, CancellationToken)	Отправляет данные по ClientWebSocket из диапазона памяти байтов, доступного только для чтения, в асинхронной операции.

SendAsync(ArraySegment<Byte>, WebSocketMessageType, Boolean, CancellationToken)

Исходный код:

ClientWebSocket.cs

Отправляет данные по ClientWebSocket в асинхронной операции.

public:
 override System::Threading::Tasks::Task ^ SendAsync(ArraySegment<System::Byte> buffer, System::Net::WebSockets::WebSocketMessageType messageType, bool endOfMessage, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task SendAsync (ArraySegment<byte> buffer, System.Net.WebSockets.WebSocketMessageType messageType, bool endOfMessage, System.Threading.CancellationToken cancellationToken);

override this.SendAsync : ArraySegment<byte> * System.Net.WebSockets.WebSocketMessageType * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function SendAsync (buffer As ArraySegment(Of Byte), messageType As WebSocketMessageType, endOfMessage As Boolean, cancellationToken As CancellationToken) As Task

Параметры

buffer

ArraySegment<Byte>

Буфер, содержащий отправляемое сообщение.

messageType

WebSocketMessageType

Одно из значений перечисления, которое указывает, содержит ли буфер открытый текст или текст в двоичном формате.

endOfMessage

Boolean

true указывает, что эта отправка является последней асинхронной отправкой; в противном случае — false.

cancellationToken

CancellationToken

Токен отмены, используемый для распространения уведомления о том, что эта операция должна быть отменена.

Возвращаемое значение

Task

Объект задачи, представляющий асинхронную операцию.

Исключения

InvalidOperationException

ClientWebSocket не подключен.

ObjectDisposedException

ClientWebSocket был закрыт.

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

Эта операция не блокируется. Возвращенный Task объект завершится после завершения запроса на отправку в ClientWebSocket экземпляре .

Для каждого ClientWebSocket объекта поддерживается только одна отправка и одно получение в параллельном режиме. Отправка нескольких отправлений одновременно не поддерживается и приведет к неопределенному поведению. Операции отправки следует сериализовать с помощью любого наиболее подходящего для вас механизма, например с помощью блокировки или семафора.

SendAsync(ReadOnlyMemory<Byte>, WebSocketMessageType, Boolean, CancellationToken)

Исходный код:

ClientWebSocket.cs

Отправляет данные по ClientWebSocket из диапазона памяти байтов, доступного только для чтения, в асинхронной операции.

public:
 override System::Threading::Tasks::ValueTask SendAsync(ReadOnlyMemory<System::Byte> buffer, System::Net::WebSockets::WebSocketMessageType messageType, bool endOfMessage, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.ValueTask SendAsync (ReadOnlyMemory<byte> buffer, System.Net.WebSockets.WebSocketMessageType messageType, bool endOfMessage, System.Threading.CancellationToken cancellationToken);

override this.SendAsync : ReadOnlyMemory<byte> * System.Net.WebSockets.WebSocketMessageType * bool * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Overrides Function SendAsync (buffer As ReadOnlyMemory(Of Byte), messageType As WebSocketMessageType, endOfMessage As Boolean, cancellationToken As CancellationToken) As ValueTask

Параметры

buffer

ReadOnlyMemory<Byte>

Область памяти, содержащая отправляемое сообщение.

messageType

WebSocketMessageType

Одно из значений перечисления, которое указывает, содержит ли буфер открытый текст или текст в двоичном формате.

endOfMessage

Boolean

true указывает, что эта отправка является последней асинхронной отправкой; в противном случае — false.

cancellationToken

CancellationToken

Токен отмены, используемый для распространения уведомления о том, что эта операция должна быть отменена.

Возвращаемое значение

ValueTask

Объект задачи, представляющий асинхронную операцию.

Исключения

InvalidOperationException

ClientWebSocket не подключен.

ObjectDisposedException

ClientWebSocket был закрыт.

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

Эта операция не блокируется. Возвращенный Task объект завершится после завершения запроса на отправку в ClientWebSocket экземпляре .

Для каждого ClientWebSocket объекта поддерживается только одна отправка и одно получение в параллельном режиме. Отправка нескольких отправлений одновременно не поддерживается и приведет к неопределенному поведению. Операции отправки следует сериализовать с помощью любого наиболее подходящего для вас механизма, например с помощью блокировки или семафора.

SendAsync(ReadOnlyMemory<Byte>, WebSocketMessageType, WebSocketMessageFlags, CancellationToken)

Исходный код:

ClientWebSocket.cs

Отправляет данные по ClientWebSocket из диапазона памяти байтов, доступного только для чтения, в асинхронной операции.

public:
 override System::Threading::Tasks::ValueTask SendAsync(ReadOnlyMemory<System::Byte> buffer, System::Net::WebSockets::WebSocketMessageType messageType, System::Net::WebSockets::WebSocketMessageFlags messageFlags, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.ValueTask SendAsync (ReadOnlyMemory<byte> buffer, System.Net.WebSockets.WebSocketMessageType messageType, System.Net.WebSockets.WebSocketMessageFlags messageFlags, System.Threading.CancellationToken cancellationToken);

override this.SendAsync : ReadOnlyMemory<byte> * System.Net.WebSockets.WebSocketMessageType * System.Net.WebSockets.WebSocketMessageFlags * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Overrides Function SendAsync (buffer As ReadOnlyMemory(Of Byte), messageType As WebSocketMessageType, messageFlags As WebSocketMessageFlags, cancellationToken As CancellationToken) As ValueTask

Параметры

buffer

ReadOnlyMemory<Byte>

Область памяти, содержащая отправляемое сообщение.

messageType

WebSocketMessageType

Одно из значений перечисления, которое указывает, содержит ли буфер открытый текст или текст в двоичном формате.

messageFlags

WebSocketMessageFlags

Побитовое сочетание значений перечисления, указывающее способ отправки сообщения.

cancellationToken

CancellationToken

Токен отмены, используемый для распространения уведомления о том, что эта операция должна быть отменена.

Возвращаемое значение

ValueTask

Объект задачи, представляющий асинхронную операцию.

Исключения

OperationCanceledException

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

Эта операция не блокируется. Возвращенный Task объект завершается после завершения запроса на отправку в ClientWebSocket экземпляре .

Для каждого ClientWebSocket объекта поддерживается только одна отправка и одно получение в параллельном режиме. Отправка нескольких отправлений одновременно не поддерживается и приведет к неопределенному поведению. Операции отправки следует сериализовать с помощью любого наиболее подходящего для вас механизма, например с помощью блокировки или семафора.