Move-Methode (ADO)

Verschiebt die Position des aktuellen Datensatzes in einem Recordset-Objekt.

Syntax

  
recordset.Move NumRecords, Start  

Parameter

NumRecords
Ein signierter Long-Ausdruck, der die Anzahl von Datensätzen angibt, um die die aktuelle Datensatzposition verschoben wird.

Starten
Optional. Ein Zeichenfolgenwert oder eine Variante, die in eine Textmarke ausgewertet wird. Sie können auch einen BookmarkEnum-Wert verwenden.

Bemerkungen

Die Move-Methode wird bei allen Recordset-Objekten unterstützt.

Wenn das NumRecords-Argument größer ist als null, wird die aktuelle Datensatzposition vorwärtsbewegt (zum Ende des Recordsets). Wenn NumRecords kleiner ist als null, wird die aktuelle Datensatzposition rückwärts verschoben (zum Anfang des Recordsets).

Wenn die aktuelle Datensatzposition durch den Move-Aufruf an eine Position vor dem ersten Datensatz verschoben würde, legt ADO den aktuellen Datensatz auf die Position vor dem ersten Datensatz im Recordset fest (BOF ist True). Beim Versuch, den Datensatz rückwärts zu verschieben, wenn die BOF-Eigenschaft bereits True ist, wird ein Fehler generiert.

Wenn die aktuelle Datensatzposition durch den Move-Aufruf an eine Position nach dem letzten Datensatz verschoben würde, legt ADO den aktuellen Datensatz auf die Position nach dem letzten Datensatz im Recordset fest (EOF ist True). Beim Versuch, den Datensatz vorwärts zu verschieben, wenn die EOF-Eigenschaft bereits True ist, wird ein Fehler generiert.

Beim Aufruf der Move-Methode aus einem leeren Recordset-Objekt wird ein Fehler generiert.

Wenn Sie das Start-Argument übergeben, erfolgt die Verschiebung relativ zum Datensatz mit dieser Textmarke (vorausgesetzt, das Recordset-Objekt unterstützt Textmarken). Ohne dieses Argument erfolgt die Verschiebung relativ zum aktuellen Datensatz.

Wenn Sie die CacheSize-Eigenschaft verwenden, um Datensätze vom Anbieter lokal zwischenzuspeichern, führt das Übergeben eines NumRecords-Arguments, mit dem die aktuelle Datensatzposition an eine Position außerhalb der aktuellen Gruppe zwischengespeicherter Datensätze verschoben wird, dazu, dass ADO eine neue Gruppe an Datensätzen abruft (beginnend mit dem Zieldatensatz). Die CacheSize-Eigenschaft bestimmt die Größe der neu abgerufenen Gruppe, und der Zieldatensatz ist der erste abgerufene Datensatz.

Wenn das Recordset-Objekt vom Typ „Nur vorwärts“ ist, können Benutzer*innen weiterhin ein NumRecords-Argument übergeben, das kleiner ist als null. Voraussetzung dafür ist, dass das Ziel sich innerhalb der aktuellen Gruppe zwischengespeicherter Datensätze befindet. Wenn die aktuelle Datensatzposition durch den Move-Aufruf in einen Datensatz vor dem ersten zwischengespeicherten Datensatz verschoben würde, tritt ein Fehler auf. Sie können also einen Datensatzcache verwenden, der das vollständige Scrollen über einen Anbieter mit Unterstützung für das „Nur vorwärts“-Scrollen unterstützt. Da zwischengespeicherte Datensätze in den Arbeitsspeicher geladen werden, sollten Sie nicht mehr Datensätze zwischenspeichern als erforderlich. Selbst wenn ein Recordset-Objekt vom Typ „Nur vorwärts“ diese Art von Verschiebungen nach hinten unterstützt, wird beim Aufruf der Methode MovePrevious für ein Recordset-Objekt vom Typ „Nur vorwärts“ ein Fehler generiert.

Hinweis

Die Unterstützung für Verschiebungen nach hinten ist bei einem Recordset-Objekt vom Typ „Nur vorwärts“ nicht vorhersehbar (abhängig von Ihrem Anbieter). Wenn der aktuelle Datensatz nach dem letzten Datensatz im Recordset positioniert wurde, führt ein Move-Aufruf nach hinten möglicherweise nicht zur richtigen aktuellen Position.

Gilt für

Recordset-Objekt (ADO)

Weitere Informationen

Move-Methode – Beispiel (VB)
Move-Methode – Beispiel (VBScript)
Move-Methode – Beispiel (VC++)
Die Methoden MoveFirst, MoveLast, MoveNext und MovePrevious (ADO)
MoveFirst-, MoveLast-, MoveNext- und MovePrevious-Methode (RDS)
MoveRecord-Methode (ADO)