Partilhar via


GZipStream.WriteAsync Método

Definição

Sobrecargas

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Grava de forma assíncrona os bytes compactados no fluxo GZip subjacente da região de memória de bytes somente leitura especificada.

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

Grava de forma assíncrona os bytes compactados no fluxo GZip subjacente da matriz de bytes especificada.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Origem:
GZipStream.cs
Origem:
GZipStream.cs
Origem:
GZipStream.cs

Grava de forma assíncrona os bytes compactados no fluxo GZip subjacente da região de memória de bytes somente leitura 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>

A região da memória da qual gravar os dados.

cancellationToken
CancellationToken

O token a se monitorar para solicitações de cancelamento. O valor padrão é None.

Retornos

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

Exceções

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

O WriteAsync método permite que você execute operações de E/S com uso intensivo de recursos sem bloquear o thread main. Essa consideração de desempenho é particularmente importante em aplicativos da área de trabalho em que uma operação de fluxo demorada pode bloquear o thread da interface do usuário e fazer com que o aplicativo apareça como se não estivesse funcionando. Os métodos assíncronos são usados em conjunto com as async palavras-chave e await no Visual Basic e no C#.

Use a CanWrite propriedade para determinar se a instância atual dá suporte à gravação.

Se a operação for cancelada antes de ser concluída, a tarefa retornada conterá o TaskStatus.Canceled valor da Task.Status propriedade .

Aplica-se a

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

Origem:
GZipStream.cs
Origem:
GZipStream.cs
Origem:
GZipStream.cs

Grava de forma assíncrona os bytes compactados no fluxo GZip subjacente da 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[]

O buffer que contém os dados a serem compactados.

offset
Int32

O deslocamento de bytes baseado em zero do qual começar a copiar bytes para o fluxo GZip.

count
Int32

O número máximo de bytes a serem gravados.

cancellationToken
CancellationToken

O token a se monitorar para solicitações de cancelamento. O valor padrão é None.

Retornos

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

Exceções

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

O WriteAsync método permite que você execute operações de E/S com uso intensivo de recursos sem bloquear o thread main. Essa consideração de desempenho é particularmente importante em aplicativos da área de trabalho em que uma operação de fluxo demorada pode bloquear o thread da interface do usuário e fazer com que o aplicativo apareça como se não estivesse funcionando. Os métodos assíncronos são usados em conjunto com as async palavras-chave e await no Visual Basic e no C#.

Use a CanWrite propriedade para determinar se a instância atual dá suporte à gravação.

Se a operação for cancelada antes de ser concluída, a tarefa retornada conterá o TaskStatus.Canceled valor da Task.Status propriedade .

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono 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