ZLibStream.CopyToAsync(Stream, Int32, CancellationToken) 方法

定義

命名空間:

System.IO.Compression

組件:

System.IO.Compression.dll

來源:

ZLibStream.cs

使用指定的緩衝區大小和取消語彙基元，以非同步的方式從目前資料流讀取位元組，並將其寫入另一個資料流。

public:
 override System::Threading::Tasks::Task ^ CopyToAsync(System::IO::Stream ^ destination, int bufferSize, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task CopyToAsync (System.IO.Stream destination, int bufferSize, System.Threading.CancellationToken cancellationToken);

override this.CopyToAsync : System.IO.Stream * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function CopyToAsync (destination As Stream, bufferSize As Integer, cancellationToken As CancellationToken) As Task

參數

destination

Stream

目前資料流的內容將複製到其中的資料流。

bufferSize

Int32

緩衝區的大小 (以位元組為單位)。 這個值必須大於零。

cancellationToken

CancellationToken

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

傳回

Task

表示非同步複製作業的工作。

例外狀況

ArgumentNullException

destination 為 null。

ArgumentOutOfRangeException

bufferSize 不是正數。

NotSupportedException

資料流程不支援讀取或寫入。

ObjectDisposedException

資料流已關閉。

InvalidOperationException

一次只允許一個非同步讀取器或寫入器。

OperationCanceledException

取消權杖已取消。 此例外狀況會儲存在傳回的工作中。

備註

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException ，仍會同步擲回。 如需預存的例外狀況，請參閱 所 CopyTo(Stream, Int32) 擲回的例外狀況。