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 der Datensätze angibt, die die aktuelle Datensatzposition verschiebt.
starten
Wahlfrei. Ein String- Wert oder Variant-, der als Textmarke ausgewertet wird. Sie können auch einen BookmarkEnum Wert verwenden.
Bemerkungen
Die Move-Methode wird für alle Recordset--Objekte unterstützt.
Wenn das argument NumRecords größer als 0 ist, wird die aktuelle Datensatzposition vorwärts verschoben (zum Ende des Recordset). Wenn NumRecords- kleiner als 0 ist, wird die aktuelle Datensatzposition rückwärts verschoben (zum Anfang des Recordset).
Wenn der Move-Aufruf die aktuelle Datensatzposition an einen Punkt vor dem ersten Datensatz verschieben würde, legt ADO den aktuellen Datensatz auf die Position vor dem ersten Datensatz im Recordset fest (BOF ist True). Ein Versuch, sich rückwärts zu bewegen, wenn die BOF--Eigenschaft bereits True einen Fehler generiert.
Wenn der Move-Aufruf die aktuelle Datensatzposition an einen Punkt nach dem letzten Datensatz verschieben würde, 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.
Durch Aufrufen der Move-Methode aus einem leeren Recordset--Objekt wird ein Fehler generiert.
Wenn Sie das Argument Start übergeben, ist die Verschiebung relativ zum Datensatz mit dieser Textmarke, vorausgesetzt, das Recordset-Objekt textmarken unterstützt. Wenn nicht angegeben, ist die Verschiebung relativ zum aktuellen Datensatz.
Wenn Sie die CacheSize-Eigenschaft verwenden, um Datensätze vom Anbieter lokal zwischenzuspeichern, wird ein NumRecords Argument übergeben, das die aktuelle Datensatzposition außerhalb der aktuellen Gruppe zwischengespeicherter Datensätze verschiebt, ADO zum Abrufen einer neuen Gruppe von Datensätzen ab 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 nur weitergeleitet wird, kann ein Benutzer weiterhin ein NumRecords Argument kleiner als 0 übergeben, vorausgesetzt, das Ziel befindet sich innerhalb der aktuellen Gruppe zwischengespeicherter Datensätze. Wenn das Verschieben Aufrufs die aktuelle Datensatzposition in einen Datensatz vor dem ersten zwischengespeicherten Datensatz verschieben würde, tritt ein Fehler auf. Daher können Sie einen Datensatzcache verwenden, der den vollständigen Bildlauf über einen Anbieter unterstützt, der nur vorwärts scrollen unterstützt. Da zwischengespeicherte Datensätze in den Arbeitsspeicher geladen werden, sollten Sie das Zwischenspeichern von mehr Datensätzen vermeiden, als erforderlich sind. Auch wenn ein vorwärtsgeschütztes Recordset--Objekt rückwärts Verschiebungen auf diese Weise unterstützt, generiert das Aufrufen der MovePrevious--Methode für alle vorwärtsgeschützten Recordset-Objekt weiterhin einen Fehler.
Anmerkung
Die Unterstützung für das Rückwärtsbewegen in einem vorwärtsgeschützten Recordset- ist je nach Anbieter nicht vorhersehbar. Wenn der aktuelle Datensatz nach dem letzten Datensatz im Recordset-positioniert wurde, führt Verschieben rückwärts möglicherweise nicht zur richtigen aktuellen Position.
Gilt für
Siehe auch
Move-Methode (Vb-Beispiel)
Move-Methode (Beispiel) (VBScript)
Move-Methode (VC++-Beispiel)
MoveFirst-, MoveLast-, MoveNext- und MovePrevious-Methoden (ADO)
Methoden MoveFirst, MoveLast, MoveNext und MovePrevious (RDS)
MoveRecord-Methode (ADO)