API:FireDAC.Comp.DataSet.TFDDataSet.Locate
Delphi
function Locate(const AKeyFields: string; const AKeyValues: Variant; AOptions: TLocateOptions = []): Boolean; override;
C++
virtual bool __fastcall Locate(const System::UnicodeString AKeyFields, const System::Variant &AKeyValues, Data::Db::TLocateOptions AOptions = Data::Db::TLocateOptions() );
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| function | public | FireDAC.Comp.DataSet.pas FireDAC.Comp.DataSet.hpp |
FireDAC.Comp.DataSet | TFDDataSet |
説明
指定したレコードをデータセット内で検索し，そのレコードをアクティブレコードにする仮想メソッドです。
FireDAC.Comp.DataSet.TFDDataSet.Locate は Data.DB.TDataSet.Locate を継承しています。以下の内容はすべて Data.DB.TDataSet.Locate を参照しています。
指定したレコードをデータセット内で検索し，そのレコードをアクティブレコードにする仮想メソッドです。
This 関数:
データセットが単方向かどうかを調べて，単方向の場合には EDatabaseError 例外を生成します。
false を返します。これは，マッチするレコードが検出されず，アクティブレコードが変更されなかったことを示します。
単方向でない下位クラスはこのメソッドをオーバーライドして，カンマで区切られた文字列 KeyFields によって識別される項目が，バリアントまたはバリアント配列 KeyValues によって指定される値を持つレコードに移動するようにすることができます。Options は大文字と小文字を区別して検索を行うかどうか，部分一致をサポートするかどうかを示します。Locate は，指定した基準にマッチするレコードが検出され，そのレコードが現在アクティブである場合に，true を返します。