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

UnmanagedMemoryStream.Read メソッド

2013/12/12

この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

指定したバイト数を指定した配列に読み取ります。

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

public override int Read(
	byte[] buffer,
	int offset,
	int count
)

パラメーター

buffer
型: System.Byte []
このメソッドが返されるときに、指定したバイト配列の offset から (offset + count - 1) までの値が、現在のソースから読み取られたバイトに置き換えられます。このパラメーターは初期化されずに渡されます。
offset
型: System.Int32
現在のストリームから読み取ったデータの格納を開始する位置を示す buffer 内のバイト オフセット。インデックス番号は 0 から始まります。
count
型: System.Int32
現在のストリームから読み取る最大バイト数。

戻り値

型: System.Int32
バッファーに読み取るバイトの総数。要求しただけのバイト数を読み取ることができなかった場合、この値は要求したバイト数より小さくなります。ストリームの末尾に到達した場合は 0 (ゼロ) になることがあります。

例外条件
ObjectDisposedException

ストリームが閉じられています。

NotSupportedException

基になるメモリが読み取りをサポートしていません。

または

CanRead プロパティは false に設定されています。

ArgumentNullException

buffer パラメーターが null に設定されています。

ArgumentOutOfRangeException

offset パラメーターが 0 未満です。

または

count パラメーターが 0 未満です。

ArgumentException

バッファー配列の長さから offset パラメーターを引いた値が、count パラメーター未満です。

offset パラメーターは、読み取りを開始する位置の array パラメーターのバイトのオフセット (バッファー インデックス) を指定し、count パラメーターは、このストリームから読み取る最大バイト数を指定します。戻り値は、実際に読み取ったバイト数であり、ストリームの末尾に到達している場合は 0 です。読み取り操作が正常に終了した場合、ストリームの現在位置は読み取ったバイト数だけ進みます。例外が発生した場合、ストリームの現在位置は変更されません。

Read メソッドは、ストリームの末尾に到達した後に必ず 0 を返します。それ以外の場合、Read は戻り値を返す前に常にストリームから少なくとも 1 バイトを読み取ります。Read の呼び出し時に利用できるデータがストリームにない場合、メソッドは少なくとも 1 バイトのデータを返すまでブロックします。ストリームの末尾に到達していなくても、要求されたバイト数より少ないバイト数を返すことがでる実装です。

Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示: