エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

Stream.ReadAsync メソッド (Byte[], Int32, Int32)

2013/12/12

現在のストリームからバイト シーケンスを非同期的に読み取り、読み取ったバイト数だけストリーム内の位置を進めます。

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

public Task<int> ReadAsync(
	byte[] buffer,
	int offset,
	int count
)

パラメーター

buffer
型: System.Byte []
データを書き込むバッファー。
offset
型: System.Int32
ストリームからのデータの書き込み開始位置を示す buffer 内のバイト オフセット。
count
型: System.Int32
読み取る最大バイト数。

戻り値

型: System.Threading.Tasks.Task<Int32>
非同期読み取り操作を表すタスク。TResult パラメーターの値には、バッファー内に読み取られた合計バイト数が含まれます。現在読み取り可能なバイト数が要求されたバイト数よりも少ない場合、この値は要求されたバイト数より小さくなることがあります。また、ストリームの末尾に到達している場合は、0 (ゼロ) になることがあります。

例外条件
ArgumentNullException

buffernull です。

ArgumentOutOfRangeException

offset または count が負の値です。

ArgumentException

offsetcount の合計値が、バッファーの長さを超えています。

NotSupportedException

ストリームが読み取りをサポートしていません。

ObjectDisposedException

ストリームが破棄されています。

InvalidOperationException

ストリームは現在、前回の読み取り操作によって使用されています。

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

現在のインスタンスが読み取りをサポートしているかどうかを判別するには、CanRead プロパティを使用します。

Windows Phone OS

サポート: 8.0

表示:
© 2015 Microsoft