GZipStream.WriteAsync Metod

Definition

Överlagringar

Name Description
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Skriver asynkront komprimerade byte till den underliggande GZip-strömmen från den angivna skrivskyddade byteminnesregionen.

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

Skriver asynkront komprimerade byte till den underliggande GZip-strömmen från den angivna bytematrisen.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Skriver asynkront komprimerade byte till den underliggande GZip-strömmen från den angivna skrivskyddade byteminnesregionen.

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

Parametrar

buffer
ReadOnlyMemory<Byte>

Den region av minne som du vill skriva data från.

cancellationToken
CancellationToken

Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.

Returer

En uppgift som representerar den asynkrona skrivåtgärden.

Undantag

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

Kommentarer

Med WriteAsync metoden kan du utföra resursintensiva I/O-åtgärder utan att blockera huvudtråden. Den här prestandaöverväganden är särskilt viktig i skrivbordsappar där en tidskrävande strömåtgärd kan blockera användargränssnittstråden och få appen att se ut som om den inte fungerar. Asynkrona metoder används tillsammans med nyckelorden async och await i Visual Basic och C#.

Använd egenskapen CanWrite för att avgöra om den aktuella instansen stöder skrivning.

Om åtgärden avbryts innan den slutförs innehåller TaskStatus.Canceled den returnerade aktiviteten värdet för Task.Status egenskapen.

Gäller för

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

Skriver asynkront komprimerade byte till den underliggande GZip-strömmen från den angivna bytematrisen.

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[] array, int offset, int count, 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 (array As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task

Parametrar

arraybuffer
Byte[]

Bufferten som innehåller de data som ska komprimeras.

offset
Int32

Den nollbaserade byteförskjutningen från vilken byte ska börja kopieras till GZip-strömmen.

count
Int32

Det maximala antalet byte som ska skrivas.

cancellationToken
CancellationToken

Token som ska övervakas för annulleringsbegäranden. Standardvärdet är None.

Returer

En uppgift som representerar den asynkrona skrivåtgärden.

Undantag

Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.

Kommentarer

Med WriteAsync metoden kan du utföra resursintensiva I/O-åtgärder utan att blockera huvudtråden. Den här prestandaöverväganden är särskilt viktig i skrivbordsappar där en tidskrävande strömåtgärd kan blockera användargränssnittstråden och få appen att se ut som om den inte fungerar. Asynkrona metoder används tillsammans med nyckelorden async och await i Visual Basic och C#.

Använd egenskapen CanWrite för att avgöra om den aktuella instansen stöder skrivning.

Om åtgärden avbryts innan den slutförs innehåller TaskStatus.Canceled den returnerade aktiviteten värdet för Task.Status egenskapen.

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Write(Byte[], Int32, Int32).

Gäller för