BOF-, EOF-Eigenschaften (ADO)

Gilt für: Access 2013, Office 2013

BOF – Gibt an, dass die aktuelle Datensatzposition vor dem ersten Datensatz in einem Recordset-Objekt liegt.

EOF – Gibt an, dass die aktuelle Datensatzposition nach dem letzten Datensatz in einem Recordset-Objekt liegt.

Rückgabewert

Die BOF- und die EOF-Eigenschaft geben Werte vom Datentyp Boolean zurück.

Hinweise

Bestimmen Sie mithilfe der Eigenschaften BOF und EOF, ob ein Recordset-Objekt Datensätze enthält oder ob Sie beim Navigieren in den Datensätzen die Grenzen eines Recordset-Objekts überschritten haben.

Die BOF-Eigenschaft gibt True (-1) zurück, falls sich die aktuelle Datensatzposition vor dem ersten Datensatz befindet, und False (0), falls sich die aktuelle Datensatzposition im oder nach dem ersten Datensatz befindet.

Die EOF-Eigenschaft gibt True zurück, falls sich die aktuelle Datensatzposition nach dem letzten Datensatz befindet, und False, falls sich die aktuelle Datensatzposition im oder vor dem letzten Datensatz befindet.

Wenn die BOF- oder die EOF-Eigenschaft True ist, gibt es keinen aktuellen Datensatz.

Wenn Sie ein Recordset-Objekt öffnen, das keine Datensätze enthält, werden die Eigenschaften BOF und EOF auf True festgelegt (weitere Informationen zu diesem Status eines Recordset-Objekts finden Sie unter der RecordCount-Eigenschaft). Wenn Sie ein Recordset-Objekt öffnen, das mindestens einen Datensatz enthält, ist der erste Datensatz der aktuelle Datensatz, und die Eigenschaften BOF und EOF sind False.

Wenn Sie den letzten verbleibenden Datensatz im Recordset-Objekt löschen, bleiben die Eigenschaften BOF und EOF so lange False, bis Sie versuchen, den aktuellen Datensatz neu zu positionieren.

In dieser Tabelle ist dargestellt, welche Move-Methoden für verschiedene Kombinationen der Eigenschaften BOF und EOF zulässig sind.

	MoveFirst, MoveLast	MovePrevious, Move < 0	Move 0	MoveNext, Move > 0
BOF=True, EOF=False	Zugelassen	Fehler	Fehler	Zugelassen
BOF=False, EOF=True	Zugelassen	Zulässig	Fehler	Fehler
Beide True	Fehler	Fehler	Fehler	Fehler
Beide False	Zulässig	Allowed	Allowed	Allowed

Das Zulassen einer Move-Methode garantiert nicht, dass die Methode einen Datensatz erfolgreich findet. Es bedeutet nur, dass beim Aufrufen der angegebenen Move-Methode kein Fehler generiert wird.

Die folgende Tabelle zeigt, was mit den Einstellungen der Eigenschaften BOF und EOF passiert, wenn Sie verschiedene Move-Methoden aufrufen, einen Datensatz aber nicht finden können.

	BOF	EOF
MoveFirst, MoveLast	Festgelegt auf True	Festgelegt auf True
Move 0	Keine Änderung	Keine Änderung
MovePrevious, Move< 0	Festgelegt auf True	Keine Änderung
MoveNext, Move> 0	Keine Änderung	Festgelegt auf True