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