GZipStream.WriteAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) |
A escrita assíncrona bytes comprimidos no fluxo GZip subjacente a partir da região de memória de bytes de apenas leitura especificada. |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Escreve assíncronamente bytes comprimidos no fluxo GZip subjacente a partir do array de bytes especificado. |
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)
- Origem:
- GZipStream.cs
- Origem:
- GZipStream.cs
- Origem:
- GZipStream.cs
- Origem:
- GZipStream.cs
- Origem:
- GZipStream.cs
A escrita assíncrona bytes comprimidos no fluxo GZip subjacente a partir da região de memória de bytes de apenas 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.ValueTaskPublic Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParâmetros
- buffer
- ReadOnlyMemory<Byte>
A região de memória de onde se pode escrever dados.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento. O valor predefinido é None.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
O WriteAsync método permite-lhe realizar operações de I/O que consomem muitos recursos sem bloquear o thread principal. Esta consideração de desempenho é particularmente importante em aplicações de ambiente de trabalho, onde uma operação de stream demorada pode bloquear o thread da interface e fazer a aplicação parecer que não está a funcionar. Os métodos assíncronos são usados em conjunto com as palavras-chave async e await em Visual Basic e C#.
Use a CanWrite propriedade para determinar se a instância atual suporta escrita.
Se a operação for cancelada antes de ser concluída, a tarefa devolvida contém 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
- Origem:
- GZipStream.cs
- Origem:
- GZipStream.cs
Escreve assíncronamente bytes comprimidos no fluxo GZip subjacente a partir do array de bytes especificado.
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(cli::array <System::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);public override System.Threading.Tasks.Task WriteAsync(byte[] array, 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, count As Integer, cancellationToken As CancellationToken) As TaskPublic Overrides Function WriteAsync (array As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As TaskParâmetros
- arraybuffer
- Byte[]
O buffer que contém os dados a comprimir.
- offset
- Int32
O deslocamento de bytes baseado em zero a partir do qual começar a copiar bytes para o fluxo GZip.
- count
- Int32
O número máximo de bytes a escrever.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento. O valor predefinido é None.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
O WriteAsync método permite-lhe realizar operações de I/O que consomem muitos recursos sem bloquear o thread principal. Esta consideração de desempenho é particularmente importante em aplicações de ambiente de trabalho, onde uma operação de stream demorada pode bloquear o thread da interface e fazer a aplicação parecer que não está a funcionar. Os métodos assíncronos são usados em conjunto com as palavras-chave async e await em Visual Basic e C#.
Use a CanWrite propriedade para determinar se a instância atual suporta escrita.
Se a operação for cancelada antes de ser concluída, a tarefa devolvida contém o TaskStatus.Canceled valor da Task.Status propriedade.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Write(Byte[], Int32, Int32).
