DeflateStream.WriteAsync Método

  • Referencia

Definición

Espacio de nombres:
System.IO.Compression
Ensamblado:
System.IO.Compression.dll
Ensamblado:
netstandard.dll

Sobrecargas

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Escribe de forma asincrónica los bytes comprimidos en la secuencia Deflate subyacente de la región de memoria de solo lectura especificada.
WriteAsync(Byte[], Int32, Int32, CancellationToken)

Escribe de forma asincrónica los bytes comprimidos en la secuencia Deflate subyacente de la matriz de bytes especificada.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Source:
DeflateStream.cs
Source:
DeflateStream.cs
Source:
DeflateStream.cs

Escribe de forma asincrónica los bytes comprimidos en la secuencia Deflate subyacente de la región de memoria de solo lectura especificada.

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 desde la que se van a escribir los datos.

cancellationToken
CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es None.

Devoluciones

ValueTask

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

Excepciones

OperationCanceledException

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

Comentarios

El WriteAsync método permite realizar operaciones de E/S intensivas en recursos sin bloquear el subproceso principal. Esta consideración de rendimiento es especialmente importante en las aplicaciones de escritorio en las que una operación de secuencia que consume mucho tiempo puede bloquear el subproceso de la interfaz de usuario y hacer que la aplicación aparezca como si no funcionara. Los métodos asincrónicos se usan junto con las async palabras clave y await en Visual Basic y C#.

Use la CanWrite propiedad para determinar si la instancia actual admite la escritura.

Si la operación se cancela antes de completarse, la tarea devuelta contiene el TaskStatus.Canceled valor de la Task.Status propiedad .

Se aplica a

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

Source:
DeflateStream.cs
Source:
DeflateStream.cs
Source:
DeflateStream.cs

Escribe de forma asincrónica los bytes comprimidos en la secuencia Deflate subyacente de la matriz de bytes especificada.

public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ array, int offset, int count, 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[] array, int offset, int count, 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 (array As Byte(), offset As Integer, count 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

arraybuffer
Byte[]

Búfer que contiene los datos que se van a comprimir.

offset
Int32

Desplazamiento de bytes de base cero desde el que se comienzan a copiar bytes en la secuencia Deflate.

count
Int32

Número máximo de bytes que se pueden escribir.

cancellationToken
CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es None.

Devoluciones

Task

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

Excepciones

OperationCanceledException

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

Comentarios

El WriteAsync método permite realizar operaciones de E/S intensivas en recursos sin bloquear el subproceso principal. Esta consideración de rendimiento es especialmente importante en las aplicaciones de escritorio en las que una operación de secuencia que consume mucho tiempo puede bloquear el subproceso de la interfaz de usuario y hacer que la aplicación aparezca como si no funcionara. Los métodos asincrónicos se usan junto con las async palabras clave y await en Visual Basic y C#.

Use la CanWrite propiedad para determinar si la instancia actual admite la escritura.

Si la operación se cancela antes de completarse, la tarea devuelta contiene el TaskStatus.Canceled valor de la Task.Status propiedad .

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, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Write(Byte[], Int32, Int32).

Se aplica a