Метод GetRows (ADO)

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

Синтаксис

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

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

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

Параметры

Строки
Необязательно. Значение GetRowsOptionEnum , указывающее количество записей для извлечения. Значение по умолчанию — adGetRowsRest.

Начало
Необязательно. Строковое значение или Variant, вычисляющее закладку для записи, с которой должна начинаться операция GetRows. Можно также использовать значение BookmarkEnum.

Поля
Необязательно. Вариант, представляющий одно имя поля или порядковое положение, или массив имен полей или порядковые номера. ADO возвращает только данные в этих полях.

Замечания

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

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

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

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

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

Применимо к

объекта набора записей

См. также

Пример метода GetRows (VB)
Пример метода GetRows (VC++)