NetworkStream.WriteAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) |
Escribe datos en NetworkStream a partir de un rango de memoria de bytes de solo lectura como una operación asincrónica. |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Escribe datos en NetworkStream desde el rango especificado de una matriz de bytes como una operación asincrónica. |
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)
- Source:
- NetworkStream.cs
- Source:
- NetworkStream.cs
- Source:
- NetworkStream.cs
Escribe datos en NetworkStream a partir de un rango 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.ValueTaskPublic Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParámetros
- buffer
- ReadOnlyMemory<Byte>
Región de memoria que contiene los datos que se van a escribir en NetworkStream.
- cancellationToken
- CancellationToken
Token para supervisar solicitudes de cancelación.
Devoluciones
Tarea que representa la operación de escritura asincrónica.
Excepciones
NetworkStream no admite escritura.
Se produjo un error al acceder al socket.
o bien
Se produjo un error al escribir en la red.
La clase NetworkStream está cerrada.
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.
Nota
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.
Nota
Si recibe un IOException, compruebe la InnerException propiedad para determinar si fue causada por un SocketException. Si es así, use la ErrorCode propiedad para obtener el código de error específico y consulte la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.
Se aplica a
WriteAsync(Byte[], Int32, Int32, CancellationToken)
- Source:
- NetworkStream.cs
- Source:
- NetworkStream.cs
- Source:
- NetworkStream.cs
Escribe datos en NetworkStream desde el rango 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(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[]
Matriz de bytes que contiene los datos que se van a escribir en NetworkStream.
- offset
- Int32
Ubicación de buffer donde se comienza a escribir los datos.
- sizecount
- Int32
Número de bytes que se van a escribir en NetworkStream.
- cancellationToken
- CancellationToken
Token para supervisar solicitudes de cancelación.
Devoluciones
Tarea que representa la operación de escritura asincrónica.
Excepciones
El parámetro buffer es null.
El parámetro offset es menor que 0.
o bien
El parámetro offset es mayor que la longitud de buffer.
o bien
El parámetro size es menor que 0.
o bien
El parámetro size es mayor que la longitud de buffer menos el valor del parámetro offset.
NetworkStream no admite escritura.
Se produjo un error al escribir en la red.
o bien
Se produjo un error al acceder al socket.
La clase NetworkStream está cerrada.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Este método se inicia en el especificado offset y envía size bytes desde el contenido de buffer a la red.
Nota
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.
Nota
Si recibe un IOException, compruebe la InnerException propiedad para determinar si fue causada por un SocketException. Si es así, use la ErrorCode propiedad para obtener el código de error específico y consulte la documentación del código de error de la 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 que no son de 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, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Write(Byte[], Int32, Int32).
