BOF, EOF Properties (ADO)

  • BOF Указывает, что текущая позиция записи находится перед первой записью в объекте Recordset .

  • EOF Указывает, что текущая позиция записи после последней записи в объекте Recordset .

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

Свойства BOF и EOF возвращают логические значения.

Замечания

Используйте свойства BOF и EOF , чтобы определить, содержит ли объект Recordset записи или выходит за пределы объекта Recordset при переходе из записи в запись.

Свойство BOF возвращает значение True (-1), если текущая позиция записи находится до первой записи и false (0), если текущая позиция записи включена или после первой записи.

Свойство EOF возвращает значение True , если текущая позиция записи после последней записи и False , если текущая позиция записи включена или до последней записи.

Если свойство BOF или EOF имеет значение True, текущая запись отсутствует.

Если открыть объект Recordset, содержащий записи, свойства BOF и EOF имеют значение True (дополнительные сведения об этом состоянии набора записей см. в свойстве RecordCount). При открытии объекта Recordset , содержащего по крайней мере одну запись, первая запись — текущая запись, а свойства BOF и EOFfalse.

Если удалить последнюю оставшуюся запись в объекте Recordset , свойства BOF и EOF могут оставаться false , пока не попытается изменить положение текущей записи.

В этой таблице показано, какие методы перемещения разрешены с различными сочетаниями свойств BOF и EOF .

MoveFirst,

MoveLast
MovePrevious,

Перемещение < 0
Перемещение 0 MoveNext,

Перемещение > 0
BOF=True, EOF=False Допустимо Ошибка Ошибка Допустимо
BOF=False, EOF=True Допустимо Допустимо Ошибка Ошибка
Оба значения true Ошибка Ошибка Ошибка Ошибка
Оба false Допустимо Допустимо Допустимо Допустимо

Разрешение метода Move не гарантирует, что метод успешно найдет запись; это означает, что вызов указанного метода Move не приведет к возникновению ошибки.

В следующей таблице показано, что происходит с параметрами свойств BOF и EOF при вызове различных методов Move , но не удается успешно найти запись.

BOF EOF
MoveFirst, MoveLast Задать значение True Задать значение True
Перемещение 0 Нет изменений Нет изменений
MovePrevious, Move< 0 Задать значение True Нет изменений
MoveNext, Move> 0 Нет изменений Задать значение True

Применимо к

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

См. также

Пример свойств BOF, EOF и закладки (VB)
Пример свойств BOF, EOF и закладки (VC++)