情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

Stream.CopyToAsync メソッド (Stream)

2013/12/12

現在のストリームからバイトを非同期的に読み取り、別のストリームにそれらを書き込みます。

Namespace:  System.IO
アセンブリ:  mscorlib (mscorlib.dll 内)

public Task CopyToAsync(
	Stream destination
)

パラメーター

destination
型: System.IO.Stream
現在のストリームの内容のコピー先となるストリーム。

戻り値

型: System.Threading.Tasks.Task
非同期コピー操作を表すタスク。

例外条件
ArgumentNullException

destinationnull です。

ObjectDisposedException

現在のストリームまたは出力先のストリームが破棄されています。

NotSupportedException

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

CopyToAsync メソッドを使用すると、メイン スレッドをブロックしないで、リソースを大量に消費する I/O 操作を実行できます。時間を要するストリーム処理によって UI スレッドがブロックされ、アプリケーションが停止しているように見える Windows Windows ストア アプリケーションまたは デスクトップ アプリケーションでは、このパフォーマンスの考慮事項が特に重要になります。非同期メソッドは、Visual Basic および C# の async キーワードおよび await キーワードと組み合わせて使用されます。

コピーは、現在のストリーム内の現在位置で開始されます。

Windows Phone OS

サポート: 8.0

表示: