GetRows メソッド (ADO)GetRows Method (ADO)

複数のレコードを取得、 Recordsetオブジェクトを配列にします。Retrieves multiple records of a Recordset object into an array.


array = recordset.GetRows(Rows, Start, Fields )  

戻り値Return Value

返します、バリアント値が 2 次元配列。Returns a Variant whose value is a two-dimensional array.


任意。Optional. A GetRowsOptionEnumを取得するレコードの数を示す値。A GetRowsOptionEnum value that indicates the number of records to retrieve. 既定値はadGetRowsRestします。The default is adGetRowsRest.

任意。Optional. A文字列値またはバリアント元となるレコードのブックマークに評価される、 GetRowsの操作を開始する必要があります。A String value or Variant that evaluates to the bookmark for the record from which the GetRows operation should begin. 使用することも、 BookmarkEnum値。You can also use a BookmarkEnum value.

任意。Optional. Aバリアントを表す 1 つのフィールド名または序数位置は、フィールド名または序数位置番号の配列。A Variant that represents a single field name or ordinal position, or an array of field names or ordinal position numbers. ADO では、これらのフィールドのデータのみを返します。ADO returns only the data in these fields.


使用して、 GetRowsからレコードをコピーする方法、レコード セット2 次元配列にします。Use the GetRows method to copy records from a Recordset into a two-dimensional array. 最初の添字は、フィールドを識別し、2 つ目は、レコード番号を識別します。The first subscript identifies the field and the second identifies the record number. 配列変数の次元は、正しいは自動的にする場合のサイズ、 GetRowsメソッドは、データを返します。The array variable is automatically dimensioned to the correct size when the GetRows method returns the data.

値を指定しない場合、引数、 GetRowsメソッド内のすべてのレコードを自動的に取得する、 Recordsetオブジェクト。If you do not specify a value for the Rows argument, the GetRows method automatically retrieves all the records in the Recordset object. 使用できるよりも多くのレコードを要求する場合GetRowsのみ使用可能なレコードの数を返します。If you request more records than are available, GetRows returns only the number of available records.

場合、 Recordsetオブジェクトは、ブックマークをサポートする、次のようにどのレコードに指定できる、 GetRowsメソッドがレコードの値を渡すことによってデータの取得を開始する必要がありますブックマークプロパティ、開始引数。If the Recordset object supports bookmarks, you can specify at which record the GetRows method should begin retrieving data by passing the value of that record's Bookmark property in the Start argument.

フィールドを制限する場合、 GetRows呼び出しを返します、1 つのフィールド名/番号またはフィールド名/番号での配列を渡すことができます、フィールド引数。If you want to restrict the fields that the GetRows call returns, you can pass either a single field name/number or an array of field names/numbers in the Fields argument.

呼び出した後GetRows、次のレコードが現在のレコードまたはEOFプロパティに設定されてTrueレコードがある場合。After you call GetRows, the next unread record becomes the current record, or the EOF property is set to True if there are no more records.

適用対象Applies To

Recordset オブジェクト (ADO)Recordset Object (ADO)

参照See Also

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