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

定義

以非同步方式從基礎資料流程讀取位元組、套用相關的密碼編譯轉換,並將結果寫入目的地資料流程。

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

傳回

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

例外狀況

destinationnull

buffersize 為負值或零。

目前資料流或目的資料流已處置。

目前資料流不支援讀取,或目的資料流不支援寫入。

進行密碼編譯作業期間發生錯誤。

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

備註

複製會從目前資料流程的目前位置開始,而且不會在複製作業完成之後重設目的地資料流程的位置。

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

適用於