GZipStream.WriteAsync 方法

定義

多載

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

從指定的唯讀位元組記憶體區域,以非同步方式將壓縮的位元組寫入基礎 GZip 資料流。

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

以非同步方式從指定位元組陣列將壓縮的位元組寫入基礎 GZip 資料流。

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

從指定的唯讀位元組記憶體區域,以非同步方式將壓縮的位元組寫入基礎 GZip 資料流。

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

參數

buffer
ReadOnlyMemory<Byte>

資料寫入來源的記憶體區域。

cancellationToken
CancellationToken

用來監視是否有取消要求的語彙基元。 預設值是 None

傳回

ValueTask

表示非同步寫入作業的工作。

備註

方法 WriteAsync 可讓您執行耗用大量資源的 I/O 作業,而不會封鎖主執行緒。 此效能考慮在Windows 8.x 市集應用程式或傳統型應用程式中特別重要,其中耗時的串流作業可能會封鎖 UI 執行緒,並讓您的應用程式顯示為無法運作。 非同步方法會與 Visual Basic 和 C# 中的 和 await 關鍵字搭配 async 使用。

CanWrite使用 屬性來判斷目前的實例是否支援寫入。

如果作業在完成之前取消,則傳回的工作會 TaskStatus.Canceled 包含 屬性的值 Task.Status

適用於

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

以非同步方式從指定位元組陣列將壓縮的位元組寫入基礎 GZip 資料流。

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

參數

arraybuffer
Byte[]

包含要壓縮之資料的緩衝區。

offset
Int32

array 中以零起始的位元組位移,要從其中開始將位元組複製到 GZip 資料流。

count
Int32

寫入的最大位元組數。

cancellationToken
CancellationToken

用來監視是否有取消要求的語彙基元。 預設值是 None

傳回

Task

表示非同步寫入作業的工作。

備註

方法 WriteAsync 可讓您執行耗用大量資源的 I/O 作業,而不會封鎖主執行緒。 此效能考慮在Windows 8.x 市集應用程式或傳統型應用程式中特別重要,其中耗時的串流作業可能會封鎖 UI 執行緒,並讓您的應用程式顯示為無法運作。 非同步方法會與 Visual Basic 和 C# 中的 和 await 關鍵字搭配 async 使用。

CanWrite使用 屬性來判斷目前的實例是否支援寫入。

如果作業在完成之前取消,則傳回的工作會 TaskStatus.Canceled 包含 屬性的值 Task.Status

適用於