BOF, свойства EOF (ADO)

Область применения: Access 2013, Office 2013

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 и EOF — False.

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

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

	MoveFirst, MoveLast	MovePrevious, Move < 0	Move 0	MoveNext, Move > 0
BOF=True, EOF=False	Разрешено	Ошибка	Ошибка	Разрешено
BOF=False, EOF=True	Разрешено	Разрешено	Ошибка	Ошибка
Оба свойства имеют значение True	Ошибка	Ошибка	Ошибка	Ошибка
Оба свойства имеют значение False	Разрешено	Разрешено	Разрешено	Разрешено

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

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

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