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

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

cancellationToken
CancellationToken

キャンセル要求を監視するためのトークン。

戻り値

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

例外

destinationnullです。

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

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

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

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

注釈

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

適用対象