Метод GetRows (ADO)GetRows Method (ADO)

Извлекает несколько записей для записей объект в массив.Retrieves multiple records of a Recordset object into an array.

СинтаксисSyntax

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

Возвращаемое значениеReturn Value

Возвращает Variant , значение которого является двумерным массивом.Returns a Variant whose value is a two-dimensional array.

ПараметрыParameters

СтрокиRows
Необязательный.Optional. Объект GetRowsOptionEnum значение, указывающее количество извлекаемых записей.A GetRowsOptionEnum value that indicates the number of records to retrieve. По умолчанию используется adGetRowsRest.The default is adGetRowsRest.

ЗапускStart
Необязательный.Optional. Объект строка значение или Variant , результатом которого является закладка для записи из которой 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.

FieldsFields
Необязательный.Optional. Объект Variant , представляющий одно поле имя или порядковый номер или массив имен полей или номера порядковый номер.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.

ПримечанияRemarks

Используйте GetRows метод копирования записей из записей в двухмерный массив.Use the GetRows method to copy records from a Recordset into a two-dimensional array. Первый индекс определяет поле, а второй определяет номер записи.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 метод автоматически получает все записи в записей объекта.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.

Если записей объект поддерживает закладки, можно указать на какие записи 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 вызов возвращает, можно передать одно поле номер и имя или массив имен полей и количества поля аргумент.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 (Visual Basic) GetRows Method Example (VB)
Пример метода GetRows (Visual C++)GetRows Method Example (VC++)