Freigeben über


BOF-, EOF-Eigenschaft (ADO)

  • 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 eigenschaften BOF und EOF geben booleschen werte zurück.

Bemerkungen

Verwenden Sie die eigenschaften BOF und EOF, um zu bestimmen, ob ein Recordset-Objekt Datensätze enthält oder ob Sie beim Verschieben von Datensatz zu Datensatz über die Grenzen eines Recordset- Objekts hinausgehen.

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 auf oder nach dem ersten Datensatz befindet.

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

Wenn entweder die BOF-- oder EOF--Eigenschaft Trueist, 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 zu diesem Status eines Recordsetfinden Sie in der eigenschaft RecordCount). 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 eigenschaften BOF und EOF möglicherweise False, bis Sie versuchen, den aktuellen Datensatz neu zu positionieren.

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

MoveFirst,

MoveLast
MovePrevious,

Verschieben < 0
Verschieben 0 MoveNext,

Verschieben > 0
BOF=True, EOF=False Erlaubt Fehler Fehler Erlaubt
BOF=False, EOF=True Erlaubt Erlaubt Fehler Fehler
Beide "True" Fehler Fehler Fehler Fehler
Beide "False" Erlaubt Erlaubt Erlaubt Erlaubt

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

In der folgenden Tabelle wird gezeigt, was mit den BOF- und EOF Eigenschafteneinstellungen geschieht, wenn Sie verschiedene Move-Methoden aufrufen, aber einen Datensatz nicht erfolgreich finden können.

BOF EOF
MoveFirst, MoveLast Auf True- festgelegt Auf True- festgelegt
Verschieben 0 Keine Änderung Keine Änderung
MovePrevious, Verschieben< 0 Auf True- festgelegt Keine Änderung
MoveNext, Verschieben> 0 Keine Änderung Auf True- festgelegt

Gilt für

Recordset-Objekt (ADO)

Siehe auch

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