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