CDaoRecordset::IsBOF

BOOL IsBOF () const;
броска (CDaoException, CMemoryException);

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

Ненулевое значение если набор записей не содержит записей, или если вы прокручен назад перед первой записью; в противном случае 0.

Примечания

Эта функция-член вызывается прежде чем перейдет от записи к записи чтобы узнать ли вы прошли перед первой записью в наборе записей. Вы также можете позвонить IsBOF наряду с IsEOF для определения ли набор записей содержит все записи или пуст. Сразу же после того, как вы называете открытым, если набор записей не содержит записей, IsBOF возвращает ненулевое значение. Когда открывается набор записей, имеющий по крайней мере одну запись, первая запись представляет текущую запись и IsBOF возвращает 0.

Если текущая запись является первая запись и вы называете MovePrev, IsBOF впоследствии возвращает ненулевое значение. Если вы называете MovePrev IsBOF возвращает ненулевое значение, это исключение. Если IsBOF возвращает ненулевое значение, текущая запись не определено, и любое действие, которое требует текущая запись приведет к выдаче исключения.

Влияние конкретных методов на IsBOF и IsEOF параметров:

Эта таблица показывает, какие операции перемещения разрешены с различными комбинациями IsBOF/IsEOF.

MoveFirst, MoveLast MovePrev,

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

Перемещение 0

Метод MoveNext,

Перемещение > 0

IsBOF= не равен нулю,
IsEOF= 0
Разрешено Исключение Исключение Разрешено
IsBOF= 0,
IsEOF= ненулевой
Разрешено Разрешено Исключение Исключение
Оба ненулевой Исключение Исключение Исключение Исключение
Оба 0 Разрешено Разрешено Разрешено Разрешено

Позволяя операции перемещения, это не означает, что операция будет успешно найти запись. Она лишь указывает, что попытка выполнить указанную операцию перемещения может и не будет создавать исключение. Значение функции-члены IsBOF и IsEOF могут изменятся в результате попытки переезда.

В следующей таблице показан эффект перемещения операций, которые не удается найти запись значения параметров IsBOF и IsEOF.

IsBOF IsEOF
MoveFirst, MoveLast Ненулевое Ненулевое
Переместить 0 Без изменений Без изменений
MovePrev, переместить < 0 Ненулевое Без изменений
MoveNext, переместить > 0 Без изменений Ненулевое

Дополнительные сведения о навигации в наборах записей, найти в статье записей DAO: навигации набора записей в Руководстве по Visual C++ программист. Соответствующую информацию в разделе "BOF, свойства EOF" в справке DAO.

Обзор CDaoRecordsetЧлены класса | Иерархическая схема

См. также CDaoRecordset::IsEOF

Index