CDaoRecordset::IsEOF

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

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

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

Примечания

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

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

Влияние конкретных методов на 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::IsBOF

Index