FileStream.CopyToAsync(Stream, Int32, CancellationToken) FileStream.CopyToAsync(Stream, Int32, CancellationToken) FileStream.CopyToAsync(Stream, Int32, CancellationToken) Method

定義

指定されたバッファー サイズとキャンセル トークンを使用して、バイトの現在のファイル ストリームからの読み取りと、別のストリームへの書き込みを非同期に行います。Asynchronously reads the bytes from the current file stream and writes them to another stream, using a specified buffer size and cancellation token.

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

パラメーター

destination
Stream Stream Stream

現在のファイル ストリームの内容のコピー先となるストリーム。The stream to which the contents of the current file stream will be copied.

bufferSize
Int32 Int32 Int32

バッファーのサイズ (バイト数)。The size, in bytes, of the buffer. これは、0 より大きい値である必要があります。This value must be greater than zero. 既定のサイズは 81920 です。The default size is 81920.

cancellationToken
CancellationToken CancellationToken CancellationToken

キャンセル要求を監視するためのトークン。The token to monitor for cancellation requests. 既定値は None です。The default value is None.

戻り値

非同期のコピー操作を表すタスク。A task that represents the asynchronous copy operation.

注釈

メソッドCopyToAsyncを使用すると、メインスレッドをブロックせずに、リソースを集中的に使用する i/o 操作を実行できます。The CopyToAsync method enables you to perform resource-intensive I/O operations without blocking the main thread. このパフォーマンスに関する考慮事項は、時間のかかるストリーム操作によって UI スレッドがブロックされ、アプリが動作していないと見なされる可能性がある Windows 8.x ストアWindows 8.x Store アプリまたはデスクトップdesktop アプリで特に重要です。This performance consideration is particularly important in a Windows 8.x ストアWindows 8.x Store app or デスクトップdesktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. 非同期メソッドは、Visual Basic およびasync await C#のキーワードと共に使用されます。The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.

操作が完了前にキャンセルされた場合、返されたTaskStatus.CanceledタスクにはTask.Statusプロパティの値が含まれます。If the operation is canceled before it completes, the returned task contains the TaskStatus.Canceled value for the Task.Status property.

コピーは、現在のファイルストリームの現在位置から開始します。Copying begins at the current position in the current file stream.

2つのストリーム間でコピーする例についCopyToAsync(Stream)ては、「オーバーロード」を参照してください。For an example of copying between two streams, see the CopyToAsync(Stream) overload.

適用対象