次の方法で共有

GetRows メソッド (ADO)

  • [アーティクル]

適用先: Access 2013、Office 2013

Recordset オブジェクトの複数のレコードを配列に取り込みます。

構文

配列 = recordset。GetRows(Rows, Start, Fields )

戻り値

2 次元配列の値を持つバリアント型 (Variant) を返します。

パラメーター

パラメーター 説明
Rows 省略可能です。 取得するレコード数を示す GetRowsOptionEnum 値を指定します。 既定値は adGetRowsRest です。
Start 省略可能です。 GetRows 操作を開始するレコードへのブックマークとして評価される文字列型 ( String ) の値またはバリアント型 ( Variant ) を指定します。 BookmarkEnum 値を使用することもできます。
Fields 省略可能です。 単一のフィールド名または順序を表す、あるいは複数のフィールド名または順序番号の配列を表す、バリアント型 ( Variant ) を指定します。 指定したフィールドのデータだけが返されます。

注釈

GetRows メソッドでは、 Recordset のレコードを 2 次元配列にコピーします。 1 番目の添え字でフィールドを指定し、2 番目の添え字でレコード番号を指定します。 GetRows メソッドからデータが返されると、array 変数は自動的に適切なサイズに調整されます。

Rows 引数の値を指定しないと、GetRows メソッドは Recordset オブジェクトのすべてのレコードを自動的に取得します。 要求したレコード数が使用可能なレコード数より多い場合、GetRows は使用可能なレコード数だけを返します。

Recordset オブジェクトがブックマークをサポートしている場合は、Start 引数にレコードの Bookmark プロパティの値を渡して、GetRows メソッドの取得開始レコードを指定できます。

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

GetRows を呼び出すと、まだ読み込まれていない次のレコードがカレント レコードになるか、それ以上レコードがない場合は EOF プロパティが True に設定されます。