FireDAC.Comp.DataSet.TFDDataSet.FindNearest
Delphi
procedure FindNearest(const AKeyValues: array of const);
C++
void __fastcall FindNearest(const System::TVarRec *AKeyValues, const System::NativeInt AKeyValues_High);
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
procedure function |
public | FireDAC.Comp.DataSet.pas FireDAC.Comp.DataSet.hpp |
FireDAC.Comp.DataSet | TFDDataSet |
説明
指定されたインデックス フィールドの値を持つレコードを検索します。
FindNearest を使用して、指定されたインデックス フィールドの値により、インデックス付きデータセット内のレコードを検索することができます。
AKeyValues は、フィールド値を含むオープン配列です。これをキーと呼びます。キー内のそれぞれの値は、リテラルでも変数でも nil でもかまいません。AKeyValues に入れて渡された値の数が検索に使用するインデックスの列の数よりも小さい場合、足りない値は nil と見なされます。
検索が成功すると、FindNearest は、一致したレコードにカーソルを置き、True を返します。成功しなければ、指定されたキーよりも大きいレコードにカーソルを置きます。
例
FDQuery1.IndexFieldNames := 'F1;F2';
FDQuery1.FindNearest([100, 'qwe']);