Freigeben über


Springen zu einem Eintrag

Mit der Move-Methode können Sie sich im Recordset eine angegebene Anzahl von Datensätzen vor- oder zurückbewegen, indem Sie die folgende Syntax verwenden:

oRs.Move NumRecords, Start  

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 ist, wird einen Fehler generieren.

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- (EOF- ist True). Ein Versuch, vorwärts zu wechseln, wenn die EOF--Eigenschaft bereits True ist, erzeugt einen Fehler.

Durch Aufrufen der Move-Methode aus einem leeren Recordset--Objekt wird ein Fehler generiert.

Wenn Sie eine Textmarke im Argument Start übergeben, ist die Verschiebung relativ zum Datensatz mit dieser Textmarke, vorausgesetzt, das Recordset-Objekt unterstützt Textmarken. Eine Textmarke wird durch die Verwendung der Bookmark-Eigenschaft abgerufen. Wenn nicht angegeben, ist die Verschiebung relativ zum aktuellen Datensatz.

Wenn Sie die CacheSize-Eigenschaft verwenden, um Datensätze vom Anbieter lokal zwischenzuspeichern, und ein NumRecords-Argument übergeben, das die aktuelle Datensatzposition außerhalb der aktuellen Gruppe zwischengespeicherter Datensätze verschiebt, zwingt dies ADO dazu, eine neue Gruppe von Datensätzen ab dem Zieldatensatz abzurufen. Die CacheSize-Eigenschaft bestimmt die Größe der neu abgerufenen Gruppe, und der Zieldatensatz ist der erste abgerufene Datensatz.