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 で指定した項目から値を持つバリアント配列を返します。