GetRows メソッド (ADO)
Recordset オブジェクトの複数のレコードを取得して配列にします。
構文
array = recordset.GetRows(Rows, Start, Fields )
戻り値
値が 2 次元配列である Variant を返します。
パラメーター
行数
省略可能。 取得するレコードの数を示す GetRowsOptionEnum 値。 既定値は adGetRowsRest です。
[開始]
省略可能。 GetRows 操作を始めるレコードのブックマークに評価される String 値または Variant。 BookmarkEnum 値も使用できます。
Fields
省略可能。 単一のフィールド名または序数位置、あるいはフィールド名または序数位置番号の配列を表す Variant。 ADO はこれらのフィールドのデータのみを返します。
注釈
GetRows メソッドを使用し、Recordset から 2 次元配列にレコードをコピーします。 最初の下付き文字によってフィールドが識別され、2 つ目の下付き文字によってレコード番号が識別されます。 "配列" 変数のサイズは、GetRows メソッドからデータが返されるとき、正しいサイズに自動的に変換されます。
Rows 引数の値を指定しない場合、GetRows メソッドによって、Recordset オブジェクトの全レコードが自動的に取得されます。 利用できる数より多いレコードを要求した場合、GetRows では、利用できるレコードの数だけが返されます。
Recordset オブジェクトでブックマークがサポートされる場合、GetRows メソッドでデータ取得の開始位置となるレコードを指定できます。具体的には、そのレコードの Bookmark プロパティの値を Start 引数に渡します。
GetRows 呼び出しで返すフィールドを制限するには、Fields 引数に単一のフィールド名/番号を渡すか、フィールド名/番号の配列を渡します。
GetRows を呼び出すと、次の未読レコードが現在のレコードになり、他にレコードがなければ EOF プロパティが True に設定されます。