Метод Move (ADO)
Перемещает позицию текущей записи в объекте Recordset.
Синтаксис
recordset.Move NumRecords, Start
Параметры
NumRecords
Подписанное выражение Long, указывающее количество записей, перемещаемых текущей позицией записи.
запуска
Необязательный. Значение string или Variant, которое оценивает закладку. Можно также использовать значение BookmarkEnum.
Замечания
Метод Move поддерживается для всех объектов набора записей.
Если аргумент NumRecords больше нуля, текущая позиция записи перемещается вперед (к концу набора записей). Если NumRecords меньше нуля, текущая позиция записи перемещается назад (к началу набора записей).
Если вызов перемещения переместит текущую позицию записи в точку перед первой записью, ADO устанавливает текущую запись в положение перед первой записью в наборе записей (BOF имеет значение True). Попытка переместиться назад, когда свойство BOF уже True создает ошибку.
Если вызов перемещения переместит текущую позицию записи в точку после последней записи, ADO устанавливает текущую запись в положение после последней записи в наборе записей (EOFTrue). Попытка перейти вперед , когда свойство EOF уже True создает ошибку.
Вызов метода перемещения из пустого объекта Recordset создает ошибку.
Если передать аргумент Start, перемещение относится к записи с этой закладкой, при условии, что объект Recordset поддерживает закладки. Если это не указано, перемещение относительно текущей записи.
Если вы используете свойство cacheSize для локального кэширования записей от поставщика, передав аргумент NumRecords, который перемещает текущую позицию записи за пределами текущей группы кэшированных записей заставляет ADO получать новую группу записей, начиная с целевой записи. Свойство CacheSize определяет размер только что полученной группы, а целевая запись — первую извлекаемую запись.
Если объект Recordset перенаправляется только, пользователь по-прежнему может передать аргумент NumRecords меньше нуля, если назначение находится в текущем наборе кэшированных записей. Если вызов перемещения переместит текущую позицию записи в запись перед первой кэшированной записью, возникнет ошибка. Таким образом, можно использовать кэш записей, поддерживающий полную прокрутку по поставщику, который поддерживает только перенаправление прокрутки. Так как кэшированные записи загружаются в память, следует избегать кэширования больше записей, чем это необходимо. Даже если объект Recordset только для перенаправления поддерживает обратное перемещение таким образом, вызов метода MovePrevious для любого объекта, доступного только для пересылки Recordset, по-прежнему приведет к возникновению ошибки.
Заметка
Поддержка перемещения назад в набор записей, доступных только для пересылки, не предсказуема в зависимости от поставщика. Если текущая запись была размещена после последней записи в наборе записей , перемещение назад может не привести к правильной текущей позиции.
Применимо к
См. также
пример метода перемещения (VB)
Пример метода перемещения (VBScript)
Пример метода перемещения (VC++)
MoveFirst, MoveLast, MoveNext и MovePrevious Methods (ADO)
MoveFirst, MoveLast, MoveNext и MovePrevious Methods (RDS)
Метод MoveRecord (ADO)