FireDAC.Comp.DataSet.TFDDataSet.FindNearest

提供: RAD Studio API Documentation
移動先: 案内検索

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']);

関連項目