Read メソッド

バイナリ型の Stream オブジェクトから、指定したバイト数のデータを読み取ります。

構文

Variant = Stream.Read ( NumBytes )

パラメータ

NumBytes   省略可能です。ファイルから読み取るバイト数を指定する長整数型 (Long) の値、または StreamReadEnum 値を指定します。既定値は adReadAll です。

戻り値

Read メソッドは、Stream オブジェクトから指定バイト数またはストリーム全体を読み取り、読み取ったデータをバリアント型 (Variant) の値として返します。

解説

NumBytes の指定バイト数が Stream の残りバイト数を超える場合は、残っているバイトのみが返されます。読み取ったデータは、NumBytes で指定された長さに一致するように補充されることはありません。読み取るバイトが残っていない場合は、Null 値を持つバリアント型の値が返されます。Read メソッドは、逆方向の読み取りには使用できません。

注意   NumBytes は、常にバイト数を表すものです。文字列型の Stream オブジェクトには、ReadText を使用してください。