BOF- und EOF-Eigenschaften (ADO)
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
Weitere Informationen
BOF-, EOF- und Bookmark-Eigenschaft – Beispiel (VB)
BOF-, EOF- und Bookmark-Eigenschaft – Beispiel (VC++)