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

定義

命名空間:

System.IO

組件:

System.Runtime.dll

來源:

FileStream.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

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

cancellationToken

CancellationToken

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

傳回

Task

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

例外狀況

OperationCanceledException

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

備註

方法 CopyToAsync 可讓您執行大量資源的 I/O 作業，而不會封鎖主執行緒。 這項效能考量對於 Windows 8.x Store 應用程式或傳統型應用程式而言特別重要，尤其是針對耗時的資料流作業可能會阻礙 UI 執行緒，使應用程式看起來像是停止運作的情況。 非同步方法會與 async Visual Basic 和 C# 中的 和 await 關鍵字搭配使用。

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

複製會從目前檔案資料流程中的目前位置開始。

如需兩個數據流之間複製的範例，請參閱 CopyToAsync(Stream) 多載。