Die Methode MoveBy

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Durch Datenmengen navigieren


Mit der Methode MoveBy können Sie angeben, um wie viele Zeilen der Cursor in einer Datenmenge vorwärts oder rückwärts bewegt werden soll. Die Bewegung erfolgt ausgehend vom aktuellen Datensatz in dem Augenblick, in dem diese Methode aufgerufen wird. MoveBy setzt auch die Eigenschaften BOF und EOF für die Datenmenge entsprechend.

Diese Funktion erwartet einen Parameter vom Typ Integer, der die Distanz angibt. Positive Zahlen kennzeichnen eine Vorwärts-, negative Zahlen eine Rückwärtsbewegung.

Anmerkung:  Bei unidirektionalen Datenmengen löst ein Aufruf der Methode MoveBy mit einer negativen Parameterangabe eine Exception aus.

MoveBy gibt die Anzahl der Zeilen zurück, um die der Cursor bewegt wurde. Wenn Sie versuchen, ihn vor den Anfang oder hinter das Ende der Datenmenge zu positionieren, unterscheidet sich die von MoveBy zurückgelieferte Distanz von der gewünschten Anzahl der Zeilen. Der Grund dafür liegt darin, dass MoveBy stoppt, wenn der erste oder der letzte Datensatz in einer Datenmenge erreicht wird.

Die folgende Anweisung bewegt den Cursor in CustTable um zwei Datensätze zurück:



 CustTable.MoveBy(-2);



 CustTable->MoveBy(-2);



Anmerkung:  Wenn die Methode MoveBy in einer Mehrbenutzer-Datenbankumgebung verwendet werden soll, müssen Sie berücksichtigen, dass sich die Datenmenge ständig verändern kann. Ein Datensatz, der gerade noch fünf Datensätze weiter hinten lag, kann sich kurz darauf schon vier, sechs oder eine unbekannte Anzahl von Datensätzen weiter hinten befinden, wenn mehrere Benutzer gleichzeitig auf die Datenbank zugreifen und die darin enthaltenen Daten ändern.

Siehe auch