Свойства 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. |
Применение
См. также:
Примеры свойств BOF, EOF и Bookmark (Visual Basic)
Примеры свойств BOF, EOF и Bookmark (VC++)