Метод 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 , если записей больше нет.
Применение
См. также:
Пример метода GetRows (Visual Basic)
Пример метода GetRows (Visual C++)