CDaoRecordset::IsEOF
呼叫此成員函式,可從資料錄捲動至資料錄了解您是否超出資料錄集的最後一筆資料錄範圍。
BOOL IsEOF( ) const;
傳回值
不是零,如果資料錄集不包含資料錄,或如果您在最後一筆資料錄之外移動;則為 0。
備註
您也可以呼叫 IsEOF 判斷資料錄集是否包含任何資料錄或是空的。 在呼叫後, 開啟,如果資料錄集並不包含資料錄, IsEOF 傳回非零。 當您開啟至少有一個資料錄的資料錄集時,第一筆資料錄保留為目前資料錄和 IsEOF 會傳回 0。
如果最後一筆資料錄保留為目前資料錄,當您呼叫 MoveNext, IsEOF 接下來將傳回非零。 如果 IsEOF 傳回非零,而且您 MoveNext呼叫,就會擲回例外狀況。 如果 IsEOF 傳回非零,目前的資料錄,則會發生未定義,而且需要一個目前記錄的所有動作都會產生例外狀況。
指定方法的效果。 IsBOF 和 IsEOF 設定:
呼叫內部 開啟 藉由呼叫 MoveFirst認可資料錄集的第一筆資料錄的目前資料錄。 因此,呼叫在空集合的 開啟 資料錄所 IsBOF 和 IsEOF 傳回非零。 ("失敗的 MoveFirst 呼叫的行為。請參閱下表)。
任何移動成功找到記錄原因 IsBOF 和 IsEOF 傳回 0 的作業。
AddNew 呼叫會成功插入新資料錄會使 IsBOF 傳回 0,不過,的 更新 呼叫後面,只有在 IsEOF 已經為非零的值。 IsEOF 狀態永遠保持不變。 所定義的 Microsoft Jet 資料庫引擎,空的資料錄集目前的資料錄指標是位於檔案結尾,因此,所有新資料錄的目前資料錄後插入。
任何 刪除 呼叫,,即使從資料錄集移除唯一餘下的記錄,將不會變更 IsBOF 或 IsEOF的值。
下表顯示哪些移動作業允許以 IsBOF/IsEOF的不同組合。
|
MoveFirst, MoveLast |
MovePrev, 移動< 0 |
移動 0 |
MoveNext, 移動> 0 |
---|---|---|---|---|
IsBOF=nonzero, IsEOF=0 |
允許 |
例外狀況 |
例外狀況 |
允許 |
IsBOF=0, IsEOF=nonzero |
允許 |
允許 |
例外狀況 |
例外狀況 |
非零的兩個 |
例外狀況 |
例外狀況 |
例外狀況 |
例外狀況 |
兩個 0 |
允許 |
允許 |
允許 |
允許 |
允許移動作業並不表示作業成功地找出資料錄。 它只表示嘗試執行指定的移動作業允許和不會產生例外狀況。 嘗試為基礎的移動, IsBOF 和 IsEOF 成員函式的值可能會變更。
的移動作業並不會記錄 IsBOF 和 IsEOF 設定的值列在下表中。
|
IsBOF |
IsEOF |
---|---|---|
MoveFirst, MoveLast |
非零 |
非零 |
移動 0 |
沒有變更 |
沒有變更 |
MovePrev, 移動 < 0 |
非零 |
沒有變更 |
MoveNext, 移動 > 0 |
沒有變更 |
非零 |
如需相關資訊,請參閱本主題中, 「BOF EOF 屬性」DAO 說明。
需求
Header: afxdao.h