CryptoStream.CopyToAsync(Stream, Int32, CancellationToken) メソッド

定義

名前空間:

System.Security.Cryptography

アセンブリ:

System.Security.Cryptography.dll

基になるストリームからバイトを非同期に読み取り、関連する暗号化変換を適用し、結果を宛先ストリームに書き込みます。

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

バッファーのサイズ (バイト数)。 これは、0 より大きい値である必要があります。 既定のサイズは 81920 です。

cancellationToken

CancellationToken

キャンセル要求を監視するためのトークン。 既定値は None です。

戻り値

Task

非同期のコピー操作を表すタスク。

例外

ArgumentNullException

destination が nullです。

ArgumentOutOfRangeException

buffersize が負の値またはゼロです。

ObjectDisposedException

現在のストリームまたはコピー先ストリームは破棄されます。

NotSupportedException

現在のストリームが読み取りをサポートしていないか、コピー先のストリームが書き込みをサポートしていません。

CryptographicException

暗号操作時にエラーが発生しました。

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

コピーは現在のストリーム内の現在の位置から開始され、コピー操作の完了後にコピー先ストリームの位置はリセットされません。

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって CopyTo(Stream, Int32)スローされる例外に関するページを参照してください。