MoveBy メソッド
提供：RAD Studio (日本語)
データセットについて：インデックス への移動
MoveBy メソッドを使用すると，データセットのカーソルを前後に移動させる行数を指定できます。移動は MoveBy が呼び出されたときの現在のレコードを基準にして相対的に行われます。また，MoveBy メソッドはデータセットの BOF および EOF プロパティを状況に応じて適切に設定します。
このメソッドには，移動するレコード数を指定する整数のパラメータがあります。正の整数は先へ進む移動を示し，負の整数は後へ戻る移動を示します。
メモ： 単方向データセットに対して負の引数を指定して MoveBy メソッドを実行すると例外が発生します。
MoveBy メソッドは移動した行数を返します。データセットの最初や最後を超えるような移動を試みた場合，MoveBy が返す行数は移動するように指定した行数と異なります。これは MoveBy がデータセットの最初や最後のレコードに到達するとそこで止まるからです。
次のコードは，CustTable で 2 レコード前に戻るためのコードです。
CustTable.MoveBy(-2);
CustTable->MoveBy(-2);
メモ： マルチユーザーデータベース環境下でアプリケーションが MoveBy メソッドを使用するときは，データセットは流動的であることを忘れないでください。複数のユーザーが同時にデータベースにアクセスして，そのデータを変更すると，ある時点で 5 レコード先にあったレコードが，わずかの間に 4 レコード先になったり，6 レコードあるいはそれ以上になったりします。