NetworkStream.WriteAsync Método

Definição

Espaço de Nomes:
System.Net.Sockets
Assemblagens:
netstandard.dll, System.Net.Sockets.dll
Assemblagem:
System.Net.Sockets.dll
Assemblagem:
netstandard.dll

Sobrecargas

Name Description
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Escreve dados a NetworkStream partir de um intervalo de bytes de memória de apenas leitura como uma operação assíncrona.
WriteAsync(Byte[], Int32, Int32, CancellationToken)

Escreve dados no NetworkStream intervalo especificado de um array de bytes como uma operação assíncrona.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Origem:
NetworkStream.cs
Origem:
NetworkStream.cs
Origem:
NetworkStream.cs
Origem:
NetworkStream.cs
Origem:
NetworkStream.cs

Escreve dados a NetworkStream partir de um intervalo de bytes de memória de apenas leitura como uma operação assíncrona.

public override System.Threading.Tasks.ValueTask WriteAsync(ReadOnlyMemory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);
override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parâmetros

buffer
ReadOnlyMemory<Byte>

Uma região de memória que contém os dados para escrever no NetworkStream.

cancellationToken
CancellationToken

O token para monitorizar pedidos de cancelamento.

Devoluções

ValueTask

Uma tarefa que representa a operação de escrita assíncrona.

Exceções

InvalidOperationException

Não NetworkStream suporta a escrita.

IOException

Ocorreu um erro ao aceder ao soquete.

-ou-

Houve uma falha ao escrever para a rede.

ObjectDisposedException

Está NetworkStream fechado.

OperationCanceledException

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

Observações

Este método envia todos os bytes para buffer a rede.

Note

Verifique se é NetworkStream gravável ligando para a CanWrite propriedade. Se tentar escrever para um NetworkStream que não é escrito, obterá um InvalidOperationException.

Note

Se receber um IOException, verifique a InnerException propriedade para determinar se foi causado por um SocketException. Se sim, utilize a propriedade ErrorCode para obter o código de erro específico e consulte a documentação do código de erro da API do Windows Sockets versão 2 para uma descrição detalhada do erro.

Aplica-se a

WriteAsync(Byte[], Int32, Int32, CancellationToken)

Origem:
NetworkStream.cs
Origem:
NetworkStream.cs
Origem:
NetworkStream.cs
Origem:
NetworkStream.cs
Origem:
NetworkStream.cs

Escreve dados no NetworkStream intervalo especificado de um array de bytes como uma operação assíncrona.

public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);
public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int size, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task WriteAsync(byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);
public override System.Threading.Tasks.Task WriteAsync(byte[] buffer, int offset, int size, System.Threading.CancellationToken cancellationToken);
override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overrides Function WriteAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task
Public Overrides Function WriteAsync (buffer As Byte(), offset As Integer, size As Integer, cancellationToken As CancellationToken) As Task

Parâmetros

buffer
Byte[]

Um array de bytes que contém os dados para escrever no NetworkStream.

offset
Int32

O local buffer de onde começar a escrever dados.

countsize
Int32

O número de bytes a escrever no NetworkStream.

cancellationToken
CancellationToken

O token para monitorizar pedidos de cancelamento.

Devoluções

Task

Uma tarefa que representa a operação de escrita assíncrona.

Exceções

ArgumentNullException

O buffer parâmetro é null.

ArgumentOutOfRangeException

O offset parâmetro é inferior a 0.

-ou-

O offset parâmetro é maior do que o comprimento de buffer.

-ou-

O size parâmetro é inferior a 0.

-ou-

O size parâmetro é maior do que o comprimento de buffer menos o valor do offset parâmetro.

InvalidOperationException

Não NetworkStream suporta a escrita.

IOException

Houve uma falha ao escrever para a rede.

-ou-

Ocorreu um erro ao aceder ao soquete.

ObjectDisposedException

Está NetworkStream fechado.

OperationCanceledException

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

Observações

Este método começa no especificado offset e envia count bytes do conteúdo de buffer para a rede.

Note

Verifique se é NetworkStream gravável ligando para a CanWrite propriedade. Se tentar escrever para um NetworkStream que não é escrito, obterá um InvalidOperationException.

Note

Se receber um IOException, verifique a InnerException propriedade para determinar se foi causado por um SocketException. Se sim, utilize a propriedade ErrorCode para obter o código de erro específico e consulte a documentação do código de erro da API do Windows Sockets versão 2 para uma descrição detalhada do erro.

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Write(Byte[], Int32, Int32).

Aplica-se a