BOF、EOF 屬性 (ADO)

  • BOF 指出目前的記錄位置是在 記錄集 物件中的第一筆記錄之前。

  • EOF 指出目前的記錄位置是在 記錄集 物件中的最後一筆記錄之後。

傳回值

BOFEOF 屬性會傳回 布林 值。

備註

當您從記錄移至記錄時,請使用 BOFEOF 屬性來判斷記錄 物件是否包含記錄,或您是否超出 記錄集 物件的限制。

如果目前的記錄位置是在第一筆記錄之前,則 BOF 屬性會傳回 True (-1) ,如果目前的記錄位置是在第一筆記錄之前或之後,則會傳回 False (0) 。

如果目前的記錄位置是在最後一筆記錄之後,則 EOF 屬性會傳回 True ,如果目前的記錄位置是在最後一筆記錄之前或之前,則會傳回 False

如果 BOFEOF 屬性為 True,則沒有目前的記錄。

如果您開啟不包含任何記錄的 記錄集 物件,則 BOFEOF 屬性會設定為 True (如需有關此 記錄集 之狀態的詳細資訊,請參閱 RecordCount屬性) 。 當您開啟至少包含一筆記錄的記錄 物件時,第一筆記錄是目前的記錄,而 BOFEOF 屬性則為 False

如果您刪除 記錄集 物件中的最後一筆記錄,則在您嘗試重新放置目前記錄之前, BOFEOF 屬性可能會維持 False

下表顯示可使用不同的 BOFEOF 屬性組合的 移動 方法。

MoveFirst

MoveLast
MovePrevious

移動 < 0
移動0 MoveNext

移動 > 0
BOF =TrueEOF = False 允許 錯誤 錯誤 允許
BOF =FalseEOF = True 允許 允許 錯誤 錯誤
兩者都 成立 錯誤 錯誤 錯誤 錯誤
兩者皆 為 False 允許 允許 允許 允許

允許 移動 方法不保證方法會成功找到記錄;這只表示呼叫指定的 Move 方法不會產生錯誤。

下表顯示當您呼叫不同的 移動 方法但無法成功找出記錄時, BOFEOF 屬性設定會發生什麼事。

轉爐 EOF
MoveFirstMoveLast 設定為 True 設定為 True
移動 0 沒有變更 沒有變更
MovePrevious移動 < 0 設定為 True 沒有變更
MoveNext移動 > 0 沒有變更 設定為 True

套用至

Recordset 物件 (ADO)

另請參閱

BOF、EOF 和 Bookmark 屬性範例 (VB)
BOF、EOF 和 Bookmark 屬性範例 (VC++)