MoveFirst-, MoveLast-, MoveNext- und MovePrevious-Methoden (ADO)
Wechselt zum ersten, letzten, nächsten oder vorherigen Datensatz in einem angegebenen Recordset -Objekt und macht diesen Datensatz zum aktuellen Datensatz.
Syntax
recordset.{MoveFirst | MoveLast | MoveNext | MovePrevious}
Bemerkungen
Verwenden Sie die MoveFirst-Methode, um die aktuelle Datensatzposition in den ersten Datensatz im Recordset-zu verschieben.
Verwenden Sie die MoveLast Methode, um die aktuelle Datensatzposition auf den letzten Datensatz im Recordsetzu verschieben. Das Recordset-Objekt muss Textmarken oder Rückwärtscursorbewegungen unterstützen. andernfalls generiert der Methodenaufruf einen Fehler.
Ein Aufruf von MoveFirst oder MoveLast-, wenn das Recordset- leer ist (sowohl BOF- als auch EOF- "True" sind), wird ein Fehler generiert.
Verwenden Sie die MoveNext-Methode, um die aktuelle Datensatzposition um einen Datensatz vorwärts zu verschieben (zum Unteren Rand des Recordset). Wenn der letzte Datensatz der aktuelle Datensatz ist und Sie die MoveNext--Methode aufrufen, legt ADO den aktuellen Datensatz auf die Position nach dem letzten Datensatz im Recordset- fest (EOF- ist True). Ein Versuch, vorwärts zu wechseln, wenn die EOF--Eigenschaft bereits True einen Fehler generiert.
Wenn in ADO 2.5 und höher das Recordset- gefiltert oder sortiert wurde und die Daten des aktuellen Datensatzes geändert werden, verschiebt das Aufrufen der MoveNext-Methode den Cursor zwei Datensätze aus dem aktuellen Datensatz vorwärts. Dies liegt daran, dass der nächste Datensatz beim Ändern des aktuellen Datensatzes zum neuen aktuellen Datensatz wird. Aufrufen MoveNext- nach der Änderung wird der Cursor um einen Datensatz vom neuen aktuellen Datensatz vorwärts verschoben. Dies unterscheidet sich vom Verhalten in ADO 2.1 und früher. In diesen früheren Versionen ändert das Ändern der Daten eines aktuellen Datensatzes im sortierten oder gefilterten Recordset- nicht die Position des aktuellen Datensatzes, und MoveNext den Cursor unmittelbar nach dem aktuellen Datensatz in den nächsten Datensatz verschiebt.
Verwenden Sie die MovePrevious--Methode, um die aktuelle Datensatzposition um einen Datensatz nach hinten zu verschieben (zum Oberen Rand des Recordset-). Das Recordset-Objekt muss Textmarken oder Rückwärtscursorbewegungen unterstützen. andernfalls generiert der Methodenaufruf einen Fehler. Wenn der erste Datensatz der aktuelle Datensatz ist und Sie die MovePrevious--Methode aufrufen, legt ADO den aktuellen Datensatz auf die Position vor dem ersten Datensatz im Recordset- (BOF ist True). Ein Versuch, sich rückwärts zu bewegen, wenn die BOF--Eigenschaft bereits True einen Fehler generiert. Wenn das Recordset-Objekt weder Textmarken noch Rückwärtscursorbewegungen unterstützt, generiert die MovePrevious--Methode einen Fehler.
Wenn das Recordset- nur vorwärts und rückwärts scrollen soll, können Sie die CacheSize-Eigenschaft verwenden, um einen Datensatzcache zu erstellen, der die Rückwärtscursorbewegung durch die Move-Methode unterstützt. Da zwischengespeicherte Datensätze in den Arbeitsspeicher geladen werden, sollten Sie das Zwischenspeichern von mehr Datensätzen vermeiden, als erforderlich ist. Sie können die MoveFirst--Methode in einem vorwärtsgeschützten Recordset--Objekt aufrufen; Dies kann dazu führen, dass der Anbieter den Befehl erneut ausführt, der das Recordset-Objekt generiert hat.
Gilt für
Siehe auch
Methoden "MoveFirst", "MoveLast", "MoveNext" und "MovePrevious" (Beispiel) (VB)
MoveFirst-, MoveLast-, MoveNext- und MovePrevious-Methoden (Beispiel) (VBScript)
MoveFirst-, MoveLast-, MoveNext- und MovePrevious-Methoden (Beispiel) (VC++)
Move-Methode (ADO)
Methoden MoveFirst, MoveLast, MoveNext und MovePrevious (RDS)
MoveRecord-Methode (ADO)