GetRows メソッド

Recordset の複数のレコードを取得して配列に格納します。

構文

Set array = recordset.GetRows(Rows, Start, Fields)

GetRows メソッドの構文には、次の指定項目があります。

指定項目	説明
Array	返されるデータを格納するバリアント型 (Variant) の変数です。
recordset	Recordset オブジェクトを表すオブジェクト変数です。
Rows	(省略可能) 取得するレコード数を示す長整数型 (Long) の式です。デフォルトは adGetRowsRest (-1) です。
Start	(省略可能) GetRows 操作を開始する最初のレコードのブックマークに評価される文字列型 (String) またはバリアント型 (Variant) です。
Fields	(省略可能) 単一のフィールド名、単一の並び順、フィールド名の配列、並び順の配列のいずれかを表すバリアント型 (Variant) です。ADO はこれらのフィールドのデータだけを返します。

解説

GetRows メソッドは、Recordset のレコードを 2 次元の配列にコピーするために使います。第 1 引数はレコード数を示し、第 2 引数はフィールドを示します。変数 array の次元は、GetRows メソッドがデータを返したときに自動的に正しいサイズに調整されます。返されるデータは読み取り専用です。

引数 Rows の指定を省略した場合、GetRows メソッドは Recordset オブジェクトのすべてのレコードを自動的に取得します。利用できるレコード数よりも多くのレコードを要求した場合には、GetRows は利用できる数のレコードだけを返します。

Recordset オブジェクトがブックマークをサポートしている場合は、対応するレコードの Bookmark プロパティの値を渡すことにより、GetRows メソッドがデータを取得する最初のレコードを指定できます。

GetRows 呼び出しで返されるフィールドの数を制限するには、引数 Fields に、単一のフィールド名、単一のフィールド番号、フィールド名の配列、フィールド番号の配列のいずれかを渡します。

GetRows を呼び出した後は、次の読み取り不可のレコードがカレント レコードになります。レコードが残っていない場合には EOF プロパティが True に設定されます。

対象

Recordset