Recordset2.BOF-Eigenschaft (DAO)

Gilt für: Access 2013, Office 2013

Gibt einen Wert zurück, der angibt, ob die aktuelle Datensatzposition in einem Recordset-Objekt vor dem ersten Datensatz liegt. Schreibgeschützter boolescher Wert.

Syntax

Ausdruck . BOF

Ausdruck Eine Variable, die ein Recordset2-Objekt darstellt.

Bemerkungen

Mit den Eigenschaften BOF und EOF können Sie feststellen, ob ein Recordset-Objekt Datensätze enthält oder ob Sie beim Wechsel zwischen Datensätzen über die Grenzen eines Recordset-Objekts navigiert sind.

Die Position des aktuellen Datensatzzeigers legt die Rückgabewerte von BOF und EOF fest.

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

If you open a Recordset object containing no records, the BOF and EOF properties are set to True, and the Recordset object's RecordCount property setting is 0. When you open a Recordset object that contains at least one record, the first record is the current record and the BOF and EOF properties are False; they remain False until you move beyond the beginning or end of the Recordset object by using the MovePrevious or MoveNext method, respectively. When you move beyond the beginning or end of the recordset, there is no current record or no record exists.

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.

Wenn Sie die MoveLast-Methode für ein Recordset-Objekt verwenden, das Datensätze enthält, wird der letzte Datensatz zum aktuellen Datensatz. Wenn Sie dann die MoveNext-Methode verwenden, wird der aktuelle Datensatz ungültig, und die EOF-Eigenschaft ist auf True festgelegt. Wenn Sie dagegen die MoveFirst-Methode für ein Recordset-Objekt verwenden, das Datensätze enthält, wird der erste Datensatz zum aktuellen Datensatz. Wenn Sie dann die MovePrevious-Methode verwenden, gibt es keinen aktuellen Datensatz, und die BOF-Eigenschaft ist auf True festgelegt.

Wenn Sie alle Datensätze in einem Recordset-Objekt verwenden, durchsucht Ihr Code gewöhnlich unter Verwendung der MoveNext-Methode die Datensätze, bis die EOF-Eigenschaft den Wert True hat.

Wenn Sie die MoveNext-Methode verwenden, während die EOF-Eigenschaft den Wert True hat, oder wenn Sie die MovePrevious-Methode verwenden, während die BOF-Eigenschaft den Wert True hat, tritt ein Fehler auf.

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	Zulässig

Wenn eine Move-Methode zulässig ist, heißt das nicht, dass die Methode einen Datensatz findet. It merely indicates that an attempt to perform the specified Move method is allowed and won't generate an error. The state of the BOF and EOF properties may change as a result of the attempted Move.

Eine OpenRecordset-Methode ruft intern eine MoveFirst-Methode auf. Wenn Sie daher eine OpenRecordset-Methode auf eine leere Gruppe von Datensätzen anwenden, werden die Eigenschaften BOF und EOF auf True gesetzt. (In der folgenden Tabelle ist das Verhalten einer fehlgeschlagenen MoveFirst-Methode aufgeführt.)

All Move methods that successfully locate a record will set both BOF and EOF to False.

Wenn Sie in einem Microsoft Access-Arbeitsbereich einem leeren Recordset einen Datensatz hinzufügen, wird die BOF-Eigenschaft auf False festgelegt, EOF bleibt jedoch True und gibt dadurch an, dass sich die aktuelle Position am Ende des Recordsets befindet.

Any Delete method, even if it removes the only remaining record from a recordset, won't change the setting of the BOF or EOF property.

Die folgende Tabelle zeigt, welche Auswirkungen Move-Methoden, bei denen ein Datensatz nicht gefunden wird, auf die Einstellungen der Eigenschaften BOF und EOF haben.

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