Метод GetRows (ADO)

Область применения: Access 2013, Office 2013

Извлекает несколько записей объекта Recordset в массив.

Синтаксис

Массива = набор записей. GetRows(Rows, Start, Fields )

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

Возвращает объект Variant , значение которого является двумерным массивом.

Параметры

Параметр	Описание
Rows	Необязательный параметр. Значение GetRowsOptionEnum , указывающее количество извлекаемых записей. Значение по умолчанию — adGetRowsRest.
Start	Необязательный параметр. Строковое значение или Variant, вычисляющее закладку для записи, с которой должна начинаться операция GetRows. Можно также использовать значение BookmarkEnum .
Fields	Необязательный параметр. Тип Variant, представляющий одно имя поля или порядковую позицию, или массив имен полей или порядковых номеров позиций. ADO возвращает только данные в этих полях.

Замечания

Используйте метод GetRows для копирования записей из recordset в двумерный массив. Первый индекс определяет поле, а второй — номер записи. Переменная массива автоматически изменяется до правильного размера, когда метод GetRows возвращает данные.

Если не указать значение для аргумента Rows , метод GetRows автоматически извлекает все записи в объекте Recordset . Если вы запрашиваете больше записей, чем доступно, GetRows возвращает только количество доступных записей.

Если объект Recordset поддерживает закладки, можно указать, с какой записи метод GetRows должен начать получение данных, передав значение свойства Bookmark этой записи в аргумент Start .

Если вы хотите ограничить поля, возвращаемые вызовом GetRows , можно передать одно имя или номер поля или массив имен полей или чисел в аргументе Fields .

После вызова GetRows следующая непрочитанные записи становится текущей записью или свойство EOF имеет значение True , если записей больше нет.