Свойства BOF и EOF (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 (дополнительные сведения об этом состоянии объекта Recordset см. в описании свойства RecordCount). При открытии объекта Recordset , содержащего хотя бы одну запись, первой записью является текущая запись, а свойства BOF и EOF имеют значение False.

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

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

MoveFirst,

MoveLast		 MovePrevious,

Переместить < 0		 Переместить 0 Movenext

Переместить > 0
BOF=True, EOF=False Разрешено Error Error Разрешено
BOF=False, EOF=True Разрешено Разрешено Error Error
Оба значения true Error Error Error Error
Оба значения False Разрешено Разрешено Разрешено Разрешено

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

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

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

Применение

Объект Recordset (ADO)

См. также:

Примеры свойств BOF, EOF и Bookmark (Visual Basic)
Примеры свойств BOF, EOF и Bookmark (VC++)