(PWS4 IIS4 IIS5)
GetRows — Recordset オブジェクトの複数のレコードを配列に取り込みます。
構文
recordset.GetRows( Rows, Start, Fields )
パラメータ
- recordset
- Recordset オブジェクを指定します。
- Rows
- 省略可能です。取得するレコード数を示す GetRowsOptionEnum 値を指定します。既定値は adGetRowsRest です。
- Start
- 省略可能です。GetRows 操作を開始するレコードのブックマークを評価する文字列型 (String) またはバリアント型 (Variant) の値を指定します。BookmarkEnum 値を使用することもできます。
- Fields
- 省略可能です。単一のフィールド名または位置を表すバリアント型 (Variant) の値、あるいは複数のフィールド名または位置を表す値の並びをバリアント型 (Variant) の配列として指定します。指定したフィールドのデータのみが返されます。
戻り値
バリアント型 (Variant) の二次元配列の値を返します。
説明
GetRows メソッドでは、Recordset のレコードを二次元配列にコピーします。最初の添え字でフィールドを指定し、2 番目でレコード番号を指定します。GetRows メソッドからデータが返されると、変数 array は自動的に正しいサイズに調整されます。
Rows 引数の値を指定しない場合は、Recordset オブジェクトのすべてのレコードが取り込まれます。利用可能なレコード数よりも大きい値を指定した場合は、利用可能なレコード数のみが返されます。
ブックマークをサポートする Recordset オブジェクトの場合、Start 引数にレコードの Bookmark プロパティの値を指定すると、GetRows メソッドでデータの取得を開始するレコードを指定できます。
GetRows メソッドで返すフィールドを限定する場合は、Fields 引数に、単一のフィールド名または番号、あるいは、複数のフィールド名または番号の配列を指定します。
GetRows メソッドを呼び出すと、まだ読み込まれていない次のレコードがカレント レコードになります。レコードがそれ以上存在しない場合は、EOF プロパティが True に設定されます。