Метод GetRows (ADO)

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

Синтаксис

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

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

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

Параметры

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

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

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

Комментарии

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

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

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

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

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

Применяется к

Объект Recordset (ADO)

См. также:

Пример метода GetRows (Visual Basic)
Пример метода GetRows (Visual C++)