NetworkStream.WriteAsync Método

  • Referência

Definição

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

Sobrecargas

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

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

Grava dados no NetworkStream do 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

Grava dados no NetworkStream de um intervalo de memória de bytes de memória ROM 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 se monitorar 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

Ocorreu um 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 para buffer a rede.

Observação

Verifique se o NetworkStream é gravável chamando a CanWrite propriedade . Se você tentar gravar em um NetworkStream que não é gravável, obterá um InvalidOperationException.

Observação

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

Grava dados no NetworkStream do 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 size, System::Threading::CancellationToken cancellationToken);
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 (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);
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, size As Integer, cancellationToken As CancellationToken) As Task
Public Overrides Function WriteAsync (buffer As Byte(), offset As Integer, count 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 do qual a gravação de dados será iniciada.

sizecount
Int32

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

cancellationToken
CancellationToken

O token a se monitorar para solicitações de cancelamento.

Retornos

Task

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

Exceções

ArgumentNullException

O parâmetro buffer é null.

ArgumentOutOfRangeException

O parâmetro offset é menor que 0.

- ou -

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

- ou -

O parâmetro size é menor que 0.

- ou -

O parâmetro size é maior que o tamanho de buffer subtraído do valor do parâmetro offset.

InvalidOperationException

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

IOException

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

- ou -

Ocorreu um 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 size bytes do conteúdo de buffer para a rede.

Observação

Verifique se o NetworkStream é gravável chamando a CanWrite propriedade . Se você tentar gravar em um NetworkStream que não é gravável, obterá um InvalidOperationException.

Observação

Se você receber um IOException, marcar a InnerException propriedade para determinar se ela foi causada por um SocketException. Nesse caso, use a ErrorCode propriedade 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 a contraparte síncrona 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