Recordset オブジェクトの複数のレコードを配列に取得します。
構文
array = recordset.GetRows(Rows, Start, Fields )
戻り値
2 次元配列の値を持つ バリアント型 (Variant) の 値を返します。
パラメーター
行数
任意。 取得するレコードの数を示す GetRowsOptionEnum 値。 既定値は adGetRowsRest です。
始める
任意。
GetRows 操作の開始元となるレコードのブックマークに評価される文字列値またはバリアント型 (Variant) の値です。
BookmarkEnum 値を使用することもできます。
フィールド
任意。 1 つのフィールド名または序数の位置、またはフィールド名または序数の位置の配列を表す バリアント型 (Variant ) の値です。 ADO は、これらのフィールド内のデータのみを返します。
注釈
レコードセットから 2 次元配列にレコードをコピーするには、GetRows メソッドを使用します。 最初の下付き文字はフィールドを識別し、2 つ目はレコード番号を識別します。 配列変数は、GetRows メソッドがデータを返すときに、正しいサイズに自動的に次元化されます。
Rows 引数に値を指定しない場合、GetRows メソッドは Recordset オブジェクト内のすべてのレコードを自動的に取得します。 使用可能なレコード数を超えるレコードを要求した場合、 GetRows は使用可能なレコードの数のみを返します。
Recordset オブジェクトがブックマークをサポートしている場合は、GetRows メソッドがデータの取得を開始するレコードを指定するには、そのレコードの Bookmark プロパティの値を Start 引数に渡します。
GetRows 呼び出しで返されるフィールドを制限する場合は、フィールド名/数値を 1 つ渡すか、フィールド名/数値の配列を Fields 引数に渡します。
GetRows を呼び出すと、次の未読レコードが現在のレコードになります。レコードがそれ以上ない場合は、EOF プロパティが True に設定されます。