CDaoRecordset::IsEOF

调用该成员函数,则在记录间移动到记录了解是否已超过记录集中的最后一条记录范围。

BOOL IsEOF( ) const;

返回值

非零,如果记录集不包含记录,或者您在最后一条记录外移动的;否则为0。

备注

还可以调用 IsEOF 确定记录集是否包含任何记录或为空。 在调用 Open后,因此,如果记录集不包含记录,IsEOF 返回非零。 当您打开包含至少一个记录的记录集时,第一条记录为当前记录,并 IsEOF 返回0。

如果最后一条记录为当前记录,调用 MoveNextIsEOF 随后将返回非零。 如果 IsEOF 返回非零,并且您调用 MoveNext,将引发异常。 如果 IsEOF 返回非零,当前记录未定义,因此,需要一个当前记录的所有事件导致异常。

给定方法的效果 IsBOFIsEOF 设置:

  • 调用内部 Open 通过调用 MoveFirst在记录集中的第一条记录当前记录。 因此,对空 Open 一组记录导致 IsBOFIsEOF 返回非零。 (对于不限定 MoveFirst 的行为参见下表称为。)

  • 所有移动成功地定位记录原因 IsBOFIsEOF 返回0的操作。

  • AddNew 调用后跟 Update 调用插入新记录将成功导致 IsBOF 返回0,不过,只有当 IsEOF 已为非零值。 IsEOF 状态将始终不变。 所定义的Microsoft Jet数据库引擎,空记录集的当前记录指针位于文件的末尾,因此,所有新记录在当前记录后插入。

  • 所有 Delete 调用,因此,即使它从记录集移除唯一的剩余的记录,则不会更改 IsBOFIsEOF的值。

此表显示哪些移动操作允许使用 IsBOF/IsEOF的不同组合。

 

MoveFirst,MoveLast

MovePrev,

移动< 0

移动0

MoveNext,

移动> 0

IsBOF=nonzero,

IsEOF=0

允许

异常

异常

允许

IsBOF=0,

IsEOF=nonzero

允许

允许

异常

异常

非零两个

异常

异常

异常

异常

两0

允许

允许

允许

允许

允许滚动操作并不意味着操作成功定位记录。 它只指示尝试执行指定的移动该权限并且不会生成异常。 由于所尝试的移动,IsBOFIsEOF 成员函数的值可以更改。

的移动操作的效果不定位记录 IsBOFIsEOF 设置的值如下表所示。

 

IsBOF

IsEOF

MoveFirstMoveLast

非零

非零

Move 0

无更改

无更改

MovePrevMove < 0

非零

无更改

MoveNextMove > 0

无更改

非零

有关相关信息,请参见主题“BOF,EOF属性” DAO帮助。

要求

Header: afxdao.h

请参见

参考

CDaoRecordset选件类

层次结构图

CDaoRecordset::IsBOF