NetworkStream.WriteAsync Método

Definición

Espacio de nombres:
System.Net.Sockets
Ensamblado:
netstandard.dll
Ensamblado:
System.Net.Sockets.dll

Sobrecargas

Nombre Description
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Escribe datos en NetworkStream desde un intervalo de memoria de bytes de solo lectura como una operación asincrónica.
WriteAsync(Byte[], Int32, Int32, CancellationToken)

Escribe datos en desde NetworkStream el intervalo especificado de una matriz de bytes como una operación asincrónica.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Escribe datos en NetworkStream desde un intervalo de memoria de bytes de solo lectura como una operación asincrónica.

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>

Región de memoria que contiene los datos que se van a escribir en .NetworkStream

cancellationToken
CancellationToken

Token que se va a supervisar para las solicitudes de cancelación.

Devoluciones

ValueTask

Tarea que representa la operación de escritura asincrónica.

Excepciones

InvalidOperationException

NetworkStream no admite la escritura.

IOException

Error al acceder al socket.

O bien

Error al escribir en la red.

ObjectDisposedException

NetworkStream Está cerrado.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Este método envía todos los bytes de buffer a la red.

Note

Compruebe si se NetworkStream puede escribir mediante una llamada a la CanWrite propiedad . Si intenta escribir en un NetworkStream objeto que no se puede escribir, obtendrá un InvalidOperationException.

Note

Si recibe un IOException, compruebe la InnerException propiedad para determinar si fue causada por .SocketException Si es así, use la propiedad ErrorCode para obtener el código de error específico y consulte la documentación del código de error de api de Windows Sockets versión 2 para obtener una descripción detallada del error.

Se aplica a

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

Escribe datos en desde NetworkStream el intervalo especificado de una matriz de bytes como una operación asincrónica.

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 size, System.Threading.CancellationToken cancellationToken);
abstract member WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
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

Parámetros

buffer
Byte[]

Matriz de bytes que contiene los datos que se van a escribir en .NetworkStream

offset
Int32

Ubicación en la buffer que se van a empezar a escribir datos.

countsize
Int32

Número de bytes que se van a escribir en .NetworkStream

cancellationToken
CancellationToken

Token que se va a supervisar para las solicitudes de cancelación.

Devoluciones

Task

Tarea que representa la operación de escritura asincrónica.

Excepciones

ArgumentNullException

El buffer parámetro es null.

ArgumentOutOfRangeException

El offset parámetro es menor que 0.

O bien

El offset parámetro es mayor que la longitud de buffer.

O bien

El size parámetro es menor que 0.

O bien

El size parámetro es mayor que la longitud de buffer menos el valor del offset parámetro.

InvalidOperationException

NetworkStream no admite la escritura.

IOException

Error al escribir en la red.

O bien

Error al acceder al socket.

ObjectDisposedException

NetworkStream Está cerrado.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Este método comienza en el especificado offset y envía count bytes desde el contenido de buffer a la red.

Note

Compruebe si se NetworkStream puede escribir mediante una llamada a la CanWrite propiedad . Si intenta escribir en un NetworkStream objeto que no se puede escribir, obtendrá un InvalidOperationException.

Note

Si recibe un IOException, compruebe la InnerException propiedad para determinar si fue causada por .SocketException Si es así, use la propiedad ErrorCode para obtener el código de error específico y consulte la documentación del código de error de api de Windows Sockets versión 2 para obtener una descripción detallada del error.

Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Write(Byte[], Int32, Int32).

Se aplica a