NetworkStream.WriteAsync Método

Definição

Namespace:
System.Net.Sockets
Assemblies:
netstandard.dll, System.Net.Sockets.dll
Assembly:
System.Net.Sockets.dll
Assembly:
netstandard.dll

Sobrecargas

Nome Description
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

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

Grava dados no NetworkStream intervalo especificado de uma matriz 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

Grava dados em NetworkStream um intervalo de memória de bytes de memória somente 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 a serem gravados no NetworkStream.

cancellationToken
CancellationToken

O token a ser monitorado para solicitações de cancelamento.

Retornos

ValueTask

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

Exceções

InvalidOperationException

O NetworkStream não dá suporte à gravação.

IOException

Erro ao acessar o soquete.

- ou -

Houve uma falha durante a gravação na rede.

ObjectDisposedException

O NetworkStream está fechado.

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

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

Note

Verifique se o NetworkStream valor é gravável chamando a CanWrite propriedade. Se você tentar escrever para um NetworkStream que não é gravável, você receberá um InvalidOperationException.

Note

Se você receber um IOException, verifique a InnerException propriedade para determinar se ela foi causada por um SocketException. Nesse caso, use 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 obter 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

Grava dados no NetworkStream intervalo especificado de uma matriz 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[]

Uma matriz de bytes que contém os dados a serem gravados no NetworkStream.

offset
Int32

O local no buffer qual começar a gravar dados.

countsize
Int32

O número de bytes a serem gravados no NetworkStream.

cancellationToken
CancellationToken

O token a ser monitorado para solicitações de cancelamento.

Retornos

Task

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

Exceções

ArgumentNullException

O buffer parâmetro é null.

ArgumentOutOfRangeException

O offset parâmetro é menor que 0.

- ou -

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

- ou -

O size parâmetro é menor que 0.

- ou -

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

InvalidOperationException

O NetworkStream não dá suporte à gravação.

IOException

Houve uma falha durante a gravação na rede.

- ou -

Erro ao acessar o soquete.

ObjectDisposedException

O NetworkStream está fechado.

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Esse método começa no especificado offset e envia count bytes do conteúdo da buffer rede.

Note

Verifique se o NetworkStream valor é gravável chamando a CanWrite propriedade. Se você tentar escrever para um NetworkStream que não é gravável, você receberá um InvalidOperationException.

Note

Se você receber um IOException, verifique a InnerException propriedade para determinar se ela foi causada por um SocketException. Nesse caso, use 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 obter uma descrição detalhada do erro.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Write(Byte[], Int32, Int32).

Aplica-se a