Datasnap.DBClient.TCustomClientDataSet.Lookup
Delphi
function Lookup(const KeyFields: string; const KeyValues: Variant; const ResultFields: string): Variant; override;
C++
virtual System::Variant __fastcall Lookup(const System::UnicodeString KeyFields, const System::Variant &KeyValues, const System::UnicodeString ResultFields);
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| function | public | Datasnap.DBClient.pas Datasnap.DBClient.hpp |
Datasnap.DBClient | TCustomClientDataSet |
説明
指定された検索値に一致するレコードから項目値を取得します。
Lookup メソッドを呼び出すと，検索条件に一致する指定した項目の値をレコードから取り出すことができます。KeyFields は，検索する項目名のセミコロン区切りのリストが入った文字列です。
KeyValues は，キー項目内で一致する値を格納するバリアントです。複数の検索値を指定するには，KeyValues をバリアント配列で引数として渡すか，Delphi では VarArrayOf ルーチンを使って実行中にバリアント配列を構築します。例（C++）:
Variant locvalues[2];
locvalues[0] = Variant("Sight Diver");
locvalues[1] = Variant("Kato Paphos");
Variant LookupResults = CustTable->Lookup("Company;City", VarArrayOf(locvalues, 1), "Company;Addr1;Addr2;State;Zip");
ResultFields は，一致するレコードから返される値を持つ項目名を，セミコロン区切りのリストに格納する文字列です。
Lookup は，ResultFields で指定した項目から値を持つバリアント配列を返します。