ClientWebSocket.SendAsync Método

Definição

Espaço de Nomes:: System.Net.WebSockets

Assemblagem:: System.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Sobrecargas

Name	Description
SendAsync(ArraySegment<Byte>, WebSocketMessageType, Boolean, CancellationToken)	Envia dados como ClientWebSocket uma operação assíncrona.
SendAsync(ReadOnlyMemory<Byte>, WebSocketMessageType, Boolean, CancellationToken)	Envia dados a ClientWebSocket partir de um intervalo de bytes de memória de apenas leitura como uma operação assíncrona.

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

Envia dados como ClientWebSocket 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.Task

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

Parâmetros

buffer: ArraySegment<Byte>

O buffer que contém a mensagem a enviar.

messageType: WebSocketMessageType

Um dos valores de enumeração que especifica se o buffer é texto claro ou em 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 esta operação deveria ser cancelada.

Devoluções

Task

O objeto tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

O ClientWebSocket não está ligado.

ObjectDisposedException

O ClientWebSocket local foi encerrado.

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

Observações

Esta operação não vai bloquear. O objeto devolvido Task será concluído depois de o pedido de envio na ClientWebSocket instância estar concluído.

Exatamente um envio e um receção são suportados em paralelo em cada ClientWebSocket objeto. Emitir múltiplos envios ao mesmo tempo não é suportado e resultará num comportamento indefinido. Deves serializar as operações de envio através do mecanismo que funcionar melhor para ti, por exemplo, usando um bloqueio ou um semáforo.

Aplica-se a

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

Envia dados a ClientWebSocket partir de um intervalo de bytes de memória de apenas 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.ValueTask

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