CDaoRecordset::IsEOF
Эта функция-член вызывается при прокрутке от записи к записи для изучения шли ли за последней записью набора записей.
BOOL IsEOF( ) const;
Возвращаемое значение
Ненулевой если набор записей не содержит записи или если прокрутили за последней записью; в противном случае – значение 0.
Заметки
Можно также вызвать IsEOF чтобы определить, содержит ли набор записей какие-либо записи или пуст. Сразу после вызова Открыть, если набор записей не содержит записи, то IsEOF возвращает ненулевое значение. При открытии набора записей, который содержит хотя бы одну запись, первая запись, возвращают 0 текущей записи и IsEOF.
Если последняя запись текущей записи, то при вызове MoveNext, IsEOF далее возвращает ненулевое значение. Если IsEOF возвращает ненулевое и вызове MoveNext, возникает исключение. Если IsEOF возвращает ненулевое, текущая запись не определена, и любое действие, требует текущей записи приведет к исключению.
Эффект определенных методов IsBOF и параметрах IsEOF:
Вызов Открыть внутренне делает первой записью в наборе записей текущей записи путем вызова MoveFirst. Таким образом, вызов Открыть в пустом набор записей будет IsBOF и IsEOF возвратить ненулевое значение. (См. следующую таблицу для расширения функциональности неудачного вызова MoveFirst).
Все операции, которые перемещаются успешно обнаруживают найти запись является причиной и IsBOF и IsEOF для возврата 0.
Вызов AddNew после вызова Обновить, который был успешно добавлен новый IsBOF возвращать записи приведет к 0, но только в том случае, если IsEOF уже не равно нулю. Состояние IsEOF всегда остается неизменным. Как определено компонента database engine для jet (Майкрософт), указатель текущей записи пустого набора записей в конце файла, поэтому любой новая запись вставляется после текущей записи.
Любой вызов Удалить, даже если он удаляет линию остальные записи из набора записей не изменяет значение IsBOF или IsEOF.
В данной таблице показан разрешены, операции перемещения с различными сочетание IsBOF/IsEOF.
|
MoveFirst, MoveLast |
MovePrev, Перемещение < 0 |
Перемещение 0 |
MoveNext Перемещение > 0 |
|---|---|---|---|---|
=nonzero,IsBOF IsEOF=0 |
Разрешено |
Исключение |
Исключение |
Разрешено |
IsBOF=0, =nonzero IsEOF |
Разрешено |
Разрешено |
Исключение |
Исключение |
Оба ненулевые |
Исключение |
Исключение |
Исключение |
Исключение |
Оба 0 |
Разрешено |
Разрешено |
Разрешено |
Разрешено |
Включение операция перемещения не означает, что операция успешно устроит запись. Оно лишь указывает, что разрешена и не будет предпринята попытка выполнить указанную операцию перемещения исключение. Значение IsBOF функций-членов и IsEOF может меняться в результате предпринятого перемещения.
Эффект перемещения операций, которые не обнаруживают найти запись на значении IsBOF и параметров IsEOF отображается в следующей таблице.
|
IsBOF |
IsEOF |
|---|---|---|
MoveFirst, MoveLast |
Ненулевой |
Ненулевой |
Переместить 0 |
Без изменений |
Без изменений |
MovePrev, Переместить < 0 |
Ненулевой |
Без изменений |
MoveNext, Переместить > 0 |
Без изменений |
Ненулевой |
Дополнительные сведения см. в разделе "BOF свойства EOF" в Справке DAO.
Требования
Header: afxdao.h