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
Siehe auch
BOF-, EOF- und Bookmark-Eigenschaft (Vb-Beispiel)
BOF-, EOF- und Bookmark-Eigenschaft (Beispiel) (VC++)