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 に設定されます。

適用対象

Recordset オブジェクト (ADO)

参照

GetRows メソッドの例 (VB)
GetRows メソッドの例 (VC++)