Bde.DBTables.TTable.GotoNearest
Delphi
procedure GotoNearest;
C++
void __fastcall GotoNearest();
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
procedure function |
public | Bde.DBTables.pas Bde.DBTables.hpp |
Bde.DBTables | TTable |
説明
現在のキーに最も近いレコードにカーソルを移動します。
GotoNearest メソッドを呼び出すと，キーバッファ内の現在のキー値で指定したのと同じレコードか，あるいはそれを超える最初のレコードにカーソルが移動します。一致するレコードまたは指定された値より大きいレコードがない場合，GotoNearest はテーブル内の最後のレコードにカーソルを移動します。
GotoNearest メソッドを呼び出す前に，データセットを dsSetKey 状態に設定するために SetKey メソッドか EditKey メソッドを呼び出してキー値を指定してから，FieldByName を使ってキーバッファに検索値を設定しなければなりません。
Paradox テーブルと dBASE テーブルの場合，キーは必ずインデックスでなければならず，IndexName プロパティで指定できます。IndexName に何も指定されていない場合，GotoNearest はテーブルの一次インデックスを使用します。GotoNearest では，dBASE の式インデックスを使用することができます。
SQL テーブルの場合，キーは IndexName プロパティで指定したインデックス，または IndexFieldNames プロパティの項目名リストと一致することがあります。
メモ： KeyExclusive は，検索範囲の一部とみなされるレコードを決定します。