ClientWebSocket.SendAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| SendAsync(ArraySegment<Byte>, WebSocketMessageType, Boolean, CancellationToken) |
Envia dados ClientWebSocket como uma operação assíncrona. |
| SendAsync(ReadOnlyMemory<Byte>, WebSocketMessageType, Boolean, CancellationToken) |
Envia dados de ClientWebSocket um intervalo de memória de bytes somente leitura como uma operação assíncrona. |
SendAsync(ArraySegment<Byte>, WebSocketMessageType, Boolean, CancellationToken)
Envia dados ClientWebSocket como uma operação assíncrona.
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.TaskPublic Overrides Function SendAsync (buffer As ArraySegment(Of Byte), messageType As WebSocketMessageType, endOfMessage As Boolean, cancellationToken As CancellationToken) As TaskParâmetros
- buffer
- ArraySegment<Byte>
O buffer que contém a mensagem a ser enviada.
- messageType
- WebSocketMessageType
Um dos valores de enumeração que especifica se o buffer é texto claro ou em um formato binário.
- endOfMessage
- Boolean
true para indicar que este é o envio assíncrono final; caso contrário, false.
- cancellationToken
- CancellationToken
Um token de cancelamento usado para propagar a notificação de que essa operação deve ser cancelada.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O ClientWebSocket não está conectado.
O ClientWebSocket foi fechado.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Essa operação não será bloqueada. O objeto retornado Task será concluído após a conclusão da solicitação de envio na ClientWebSocket instância.
Há suporte para exatamente um envio e um recebimento em cada ClientWebSocket objeto em paralelo. Não há suporte para a emissão de vários envios ao mesmo tempo e resultará em um comportamento indefinido. Você deve serializar operações de envio por meio de qualquer mecanismo que funcione melhor para você, por exemplo, usando um bloqueio ou um semáforo.
Aplica-se a
SendAsync(ReadOnlyMemory<Byte>, WebSocketMessageType, Boolean, CancellationToken)
Envia dados de ClientWebSocket um intervalo de memória de bytes somente leitura como uma operação assíncrona.
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.ValueTaskPublic Overrides Function SendAsync (buffer As ReadOnlyMemory(Of Byte), messageType As WebSocketMessageType, endOfMessage As Boolean, cancellationToken As CancellationToken) As ValueTaskParâmetros
- buffer
- ReadOnlyMemory<Byte>
A região da memória que contém a mensagem a ser enviada.
- messageType
- WebSocketMessageType
Um dos valores de enumeração que especifica se o buffer é texto claro ou em um formato binário.
- endOfMessage
- Boolean
true para indicar que este é o envio assíncrono final; caso contrário, false.
- cancellationToken
- CancellationToken
Um token de cancelamento usado para propagar a notificação de que essa operação deve ser cancelada.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O ClientWebSocket não está conectado.
O ClientWebSocket foi fechado.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Essa operação não será bloqueada. O objeto retornado Task será concluído após a conclusão da solicitação de envio na ClientWebSocket instância.
Há suporte para exatamente um envio e um recebimento em cada ClientWebSocket objeto em paralelo. Não há suporte para a emissão de vários envios ao mesmo tempo e resultará em um comportamento indefinido. Você deve serializar operações de envio por meio de qualquer mecanismo que funcione melhor para você, por exemplo, usando um bloqueio ou um semáforo.