Methoden MoveFirst, MoveLast, MoveNext und MovePrevious (ADO)

Gilt für: Access 2013, Office 2013

Wechselt zum ersten, letzten, nächsten oder vorherigen Datensatz in einem angegebenen Recordset-Objekt. Mithilfe dieser Funktionen wird dieser Datensatz zum aktuellen Datensatz.

Syntax

recordset. { MoveFirst | MoveLast | MoveNext | MovePrevious}

Hinweise

Verwenden Sie die MoveFirst -Methode, um die aktuelle Position des Datensatzes an die Position des ersten Datensatzes im Recordset -Objekt zu verschieben.

Verwenden Sie die MoveLast-Methode , um die aktuelle Datensatzposition in den letzten Datensatz im Recordset zu verschieben. Das Recordset-Objekt muss Lesezeichen oder Rückwärtsbewegungen des Cursors unterstützen. Andernfalls generiert der Methodenaufruf einen Fehler.

A call to either MoveFirst or MoveLast when the Recordset is empty (both BOF and EOF are True) generates an error.

Verwenden Sie die MoveNext-Methode, um die aktuelle Position des Datensatzes um einen Datensatz nach vorn zu verschieben (zum Ende des Recordset-Objekts). Wenn es sich beim letzten Datensatz um den aktuellen Datensatz handelt und die MoveNext-Methode aufgerufen wird, legt ADO den aktuellen Datensatz auf die Position nach dem letzten Datensatz im Recordset-Objekt fest (EOF hat den Wert True). Beim Versuch, den Datensatz nach vorn zu verschieben, wenn die EOF -Eigenschaft bereits auf True festgelegt ist, wird ein Fehler generiert.

Wenn Recordset -Objekt gefiltert oder sortiert wird und die Daten des aktuellen Datensatzes geändert wurden, ändert sich die Position möglicherweise ebenso. In solchen Fällen wird die MoveNext -Methode ordnungsgemäß ausgeführt, aber Sie sollten wissen, dass die Position von der neuen Position (und nicht von der vorherigen Position) aus um einen Datensatz nach vorn verschoben wird. Wenn Sie beispielsweise die Daten im aktuellen Datensatz ändern, sodass der Datensatz an das Ende des sortierten Recordset verschoben wird, bedeutet dies, dass das Aufrufen von MoveNext dazu führt, dass ADO den aktuellen Datensatz auf die Position nach dem letzten Datensatz im Recordset festlegt (EOF = True).

Verwenden Sie die MovePrevious-Methode , um die aktuelle Datensatzposition um einen Datensatz nach hinten (an den Anfang des Recordset-Objekts) zu verschieben. Das Recordset-Objekt muss Lesezeichen oder Rückwärtsbewegungen des Cursors 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 fest (BOF ist True). Beim Versuch, den Datensatz nach hinten zu verschieben, wenn die BOF -Eigenschaft bereits auf True festgelegt ist, wird ein Fehler generiert. Wenn das Recordset-Objekt weder Lesezeichen noch Rückwärtsbewegungen des Cursors unterstützt, generiert die MovePrevious-Methode einen Fehler.

Ist das Recordset -Objekt vorwärtsgerichtet, und Sie möchten, dass der vorwärtsgerichtete und der rückwärtsgerichtete Bildlauf unterstützt wird, können Sie die CacheSize-Eigenschaft verwenden, um einen Datensatzcache zu erstellen, der eine rückwärtsgerichtete Verschiebung des Cursors mithilfe der Move-Methode unterstützt. Da zwischengespeicherte Datensätze in den Speicher geladen werden, sollten Sie nur so viele Datensätze wie erforderlich zwischenspeichern. Sie können die MoveFirst -Methode in einem vorwärtsgerichteten Recordset -Objekt aufrufen, wodurch der Anbieter den Befehl, mit dem das Recordset -Objekt generiert wird, möglicherweise erneut ausführt.