BOF- und EOF-Eigenschaften (ADO)

  • Artikel

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

  • EOF gibt an, dass die aktuelle Datensatzposition hinter dem letzten Datensatz in einem Recordset-Objekt liegt.

Rückgabewert

Die BOF- und EOF-Eigenschaften geben boolesche Werte zurück.

Bemerkungen

Verwenden Sie die BOF- und EOF-Eigenschaften, um festzustellen, ob ein Recordset-Objekt Datensätze enthält oder ob Sie über die Grenzen eines Recordset-Objekts hinausgehen, wenn Sie von Datensatz zu Datensatz wechseln.

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

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

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

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

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

In dieser Tabelle wird gezeigt, welche Move-Methoden mit unterschiedlichen Kombinationen der BOF- und EOF-Eigenschaften zulässig sind.

MoveFirst,

MoveLast		 MovePrevious,

Move < 0		 Move 0 MoveNext,

Move > 0
BOF=True, EOF=False Zulässig Fehler Fehler Zulässig
BOF=False, EOF=True Zulässig Zulässig Fehler Fehler
Beide True Fehler Fehler Fehler Fehler
Beide False Zulässig Zulässig Zulässig Zulässig

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

In der folgenden Tabelle wird gezeigt, was mit den Einstellungen der BOF- und EOF-Eigenschaft geschieht, wenn Sie verschiedene Move-Methoden aufrufen, jedoch keinen Datensatz finden.

BOF EOF
MoveFirst, MoveLast Auf True einstellen Auf True einstellen
Move 0 Keine Änderung Keine Änderung
MovePrevious, Move< 0 Auf True einstellen Keine Änderung
MoveNext, Move> 0 Keine Änderung Auf True einstellen

Gilt für

Recordset-Objekt (ADO)

Weitere Informationen

BOF-, EOF- und Bookmark-Eigenschaft – Beispiel (VB)
BOF-, EOF- und Bookmark-Eigenschaft – Beispiel (VC++)