Метод GetRows (ADO)

  • Статья

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

Синтаксис

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

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

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

Параметры

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

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

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

Комментарии

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

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

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

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

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

Применение

Объект Recordset (ADO)

См. также:

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