CryptoStream.CopyToAsync(Stream, Int32, CancellationToken) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
基になるストリームからバイトを非同期に読み取り、関連する暗号化変換を適用して、結果を宛先ストリームに書き込みます。
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.TaskPublic Overrides Function CopyToAsync (destination As Stream, bufferSize As Integer, cancellationToken As CancellationToken) As Taskパラメーター
- destination
- Stream
現在のストリームの内容のコピー先となるストリーム。
- bufferSize
- Int32
バッファーのサイズ (バイト単位)。 この値は 0 より大きくする必要があります。 既定のサイズは 81920 です。
- cancellationToken
- CancellationToken
キャンセル要求を監視するトークン。 既定値は None です。
返品
非同期コピー操作を表すタスク。
例外
destination は nullです。
bufferSize が負またはゼロです。
現在のストリームまたは宛先ストリームのいずれかが破棄されます。
現在のストリームでは読み取りがサポートされていないか、宛先ストリームが書き込みをサポートしていません。
暗号化操作中にエラーが発生しました。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
コピーは現在のストリーム内の現在の位置から開始され、コピー操作が完了した後にコピー先ストリームの位置はリセットされません。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 CopyTo(Stream, Int32)によってスローされる例外を参照してください。
