NetworkStream.WriteAsync 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
| 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.ValueTaskPublic Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParâ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
Uma tarefa que representa a operação de gravação assíncrona.
Exceções
O NetworkStream não dá suporte à gravação.
Ocorreu um erro ao acessar o soquete.
- ou -
Houve uma falha durante a gravação na rede.
O NetworkStream está fechado.
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.Taskoverride this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overrides Function WriteAsync (buffer As Byte(), offset As Integer, size As Integer, cancellationToken As CancellationToken) As TaskPublic Overrides Function WriteAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As TaskParâ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
Uma tarefa que representa a operação de gravação assíncrona.
Exceções
O parâmetro buffer é null.
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.
O NetworkStream não dá suporte à gravação.
Houve uma falha durante a gravação na rede.
- ou -
Ocorreu um erro ao acessar o soquete.
O NetworkStream está fechado.
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).
