共用方式為


CDaoRecordset::IsBOF

呼叫此成員函式,從資料錄捲動至資料錄學習之前,移至您是否在資料錄集的第一個資料錄之前。

BOOL IsBOF( ) const;

傳回值

不是零,如果資料錄集不包含資料錄,或如果反向移動,在第一個資料錄之前,則為 0。

備註

您可以使用 IsEOF 一起呼叫 IsBOF 判斷資料錄集是否包含任何資料錄或是空的。 在呼叫後, 開啟,如果資料錄集並不包含資料錄, IsBOF 傳回非零。 當您開啟至少有一個資料錄的資料錄集時,第一筆資料錄保留為目前資料錄和 IsBOF 會傳回 0。

如果第一筆資料錄保留為目前資料錄,並呼叫 MovePrevIsBOF 接下來將傳回非零。 如果 IsBOF 傳回非零,而且您 MovePrev呼叫,就會擲回例外狀況。 如果 IsBOF 傳回非零,目前的資料錄,則會發生未定義,而且需要一個目前記錄的所有動作都會產生例外狀況。

指定方法的效果。 IsBOFIsEOF 設定:

  • 呼叫內部 開啟 藉由呼叫 MoveFirst認可資料錄集的第一筆資料錄的目前資料錄。 因此,呼叫在空集合的 開啟 資料錄所 IsBOFIsEOF 傳回非零。 ("失敗的 MoveFirstMoveLast 呼叫的行為。請參閱下表)。

  • 任何移動成功找到記錄原因 IsBOFIsEOF 傳回 0 的作業。

  • AddNew 呼叫會成功插入新資料錄會使 IsBOF 傳回 0,不過,的 更新 呼叫後面,只有在 IsEOF 已經為非零的值。 IsEOF 狀態永遠保持不變。 所定義的 Microsoft Jet 資料庫引擎,空的資料錄集目前的資料錄指標是位於檔案結尾,因此,所有新資料錄的目前資料錄後插入。

  • 任何 刪除 呼叫,,即使從資料錄集移除唯一餘下的記錄,將不會變更 IsBOFIsEOF的值。

下表顯示哪些移動作業允許以 IsBOF/IsEOF的不同組合。

 

MoveFirst, MoveLast

MovePrev,

移動< 0

移動 0

MoveNext,

移動> 0

IsBOF=nonzero,

IsEOF=0

允許

例外狀況

例外狀況

允許

IsBOF=0,

IsEOF=nonzero

允許

允許

例外狀況

例外狀況

非零的兩個

例外狀況

例外狀況

例外狀況

例外狀況

兩個 0

允許

允許

允許

允許

允許移動作業並不表示作業成功地找出資料錄。 它只表示嘗試執行指定的移動作業允許和不會產生例外狀況。 嘗試為基礎的移動, IsBOFIsEOF 成員函式的值可能會變更。

的移動作業並不會記錄 IsBOFIsEOF 設定的值列在下表中。

 

IsBOF

IsEOF

MoveFirstMoveLast

非零

非零

移動 0

沒有變更

沒有變更

MovePrev移動 < 0

非零

沒有變更

MoveNext移動 > 0

沒有變更

非零

如需相關資訊,請參閱本主題中, 「BOF EOF 屬性」DAO 說明。

需求

Header: afxdao.h

請參閱

參考

CDaoRecordset 類別

階層架構圖

CDaoRecordset::IsEOF