IsolatedStorageFileStream.Read メソッド

現在のバッファ IsolatedStorageFileStream から配列にバイトをコピーします。

Overrides Public Function Read( _
   ByVal buffer() As Byte, _   ByVal offset As Integer, _   ByVal count As Integer _) As Integer
[C#]
public override int Read(byte[] buffer,intoffset,intcount);
[C++]
public: int Read(unsigned charbuffer __gc[],intoffset,intcount);
[JScript]
public override function Read(
   buffer : Byte[],offset : int,count : int) : int;

パラメータ

• buffer
  読み取るバッファ。
• offset
  書き込みの開始位置を示すバッファ内のオフセット。
• count
  読み取る最大バイト数。

戻り値

buffer に読み取る合計バイト数。要求しただけのバイト数を読み取ることができなかった場合、この値は要求したバイト数より小さくなります。ストリームの末尾に到達した場合は 0 になることがあります。

解説

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

Read メソッドは、実際の型にかかわらず、 buffer パラメータをバイトのブロックとして処理します。同様に、 offset パラメータと count パラメータは、必ずバイトで指定します。バイト配列以外の buffer パラメータでは、 offset に対する正確な値または count を算出するために、要素インデックスにバイト単位の要素サイズを掛け合わせる必要があります。

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

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

IsolatedStorageFileStream クラス | IsolatedStorageFileStream メンバ | System.IO.IsolatedStorage 名前空間