CDaoRecordset::IsEOF

Rufen Sie die Memberfunktion auf, wie Sie von Datensatz zu Datensatz wechseln, um zu erfahren, ob Sie über den letzten Datensatz des Recordsets hinausgegangen haben.

BOOL IsEOF( ) const;

Rückgabewert

ungleich 0 (null), wenn das Recordset keine Datensätze enthält, oder wenn Sie über dem letzten Datensatz hinaus gescrollt haben; 0 andernfalls.

Hinweise

Sie können IsEOF auch aufrufen, um zu bestimmen, ob das Recordset alle Datensätze enthält oder leer ist.Unmittelbar nach dem Sie Open aufrufen, wenn das Recordset keine Datensätze enthält, gibt IsEOF-Wert ungleich 0 (null) zurück.Wenn Sie ein Recordset öffnen, das mindestens einen Datensatz ist, ist der erste Datensatz die gibt 0 des aktuellen Datensatzes und IsEOF.

Wenn der letzte Datensatz der aktuelle Datensatz ist, wenn Sie MoveNext aufrufen, gibt IsEOF nach Wert ungleich 0 (null) zurück.Wenn IsEOF-Wert ungleich 0 zurückgibt und Sie MoveNext aufrufen, wird eine Ausnahme ausgelöst.Wenn IsEOF-Wert ungleich 0 zurückgibt, wird der aktuelle Datensatz nicht definiert, und jede Aktion, die einen aktuellen Datensatz erfordert, führt eine Ausnahme.

Auswirkungen bestimmter Methoden auf IsBOF und IsEOF Einstellungen:

• Das Aufrufen von Open intern macht den ersten Datensatz des Recordsets den aktuellen Datensatz, indem MoveFirst aufruft.Daher bewirkt das Aufrufen von Open auf eine leere Menge Datensätzen IsBOF und IsEOF, Wert ungleich 0 zurückzugeben.(Siehe die folgende Tabelle für das Verhalten eines fehlgeschlagenen MoveFirst Aufrufs.)

• Alle Verschiebungsvorgänge, die erfolgreich eine Rekordursache IsBOF und IsEOF suchen, um 0 zurückzugeben.

• Ein AddNew Aufruf, der von einem Update Aufruf folgt, der erfolgreich einen neuen Datensatz einfügt, wird IsBOF, 0 zurückzugeben, jedoch nur, wenn IsEOF bereits ungleich 0 (null) ist.Der Zustand des IsEOF verbleibt stets unverändert.Wie durch das Microsoft Jet-Datenbankmodul definiert, ist der Zeiger für den aktuellen Datensatz eines leeren Recordsets am Ende einer Datei, sodass jeder neue Datensatz nach dem aktuellen Datensatz eingefügt.

• Kein Delete Aufruf, auch wenn er den einzigen verbleibenden Datensatz aus einem Recordset entfernt, ändert nicht den Wert von IsBOF oder von IsEOF.

Diese Tabelle zeigt, welche Verschiebungsvorgänge mit verschiedenen Kombinationen von IsBOF/IsEOF zugelassen werden.

Erstellen eines Verschiebungsvorgang zuzulassen bedeutet nicht, dass der Vorgang erfolgreich einen Satz findet.Es gibt lediglich an, dass versucht wurde, den angegebenen Verschiebungsvorgang auszuführen ist zulässig und wird keine Ausnahme generieren.Der Wert der IsBOF und IsEOF-Memberfunktionen ändert aufgrund der Verschiebung versucht haben.

Der Zweck von Verschiebungsvorgängen, die keinen Satz auf dem Wert von IsBOF und von IsEOF Einstellungen finden, wird in der folgenden Tabelle gezeigt.

Weitere Informationen finden Sie im Thema "BOF, EOF-Eigenschaften" in der DAO-Hilfe.

Anforderungen

Header: afxdao.h

Siehe auch

Referenz

CDaoRecordset-Klasse

Hierarchien-Diagramm

CDaoRecordset::IsBOF