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