IBX.IBCustomDataSet.TIBCustomDataSet.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);
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | IBX.IBCustomDataSet.pas IBX.IBCustomDataSet.hpp |
IBX.IBCustomDataSet | TIBCustomDataSet |
Description
Récupère des valeurs de champs à partir d'un enregistrement correspondant à des valeurs de recherche spécifiées.
Appelez Lookup pour récupérer les valeurs des champs spécifiés, à partir d'un enregistrement répondant à des critères de recherche. KeyFields
est une chaîne contenant une liste délimitée par des points-virgules des noms de champs à utiliser pour la recherche.
KeyValues
est un tableau de variants contenant les valeurs à rechercher dans les champs clé. Pour spécifier plusieurs valeurs de recherche, transmettez un tableau de variants
KeyValues
comme argument, ou construisez un tableau de variants à la volée en utilisant la routine VarArrayOf.
ResultFields
est une chaîne contenant une liste délimitée par des points-virgules des noms de champs dont les valeurs doivent être renvoyées à partir de l'enregistrement correspondant.
Lookup renvoie un tableau de variants contenant les valeurs des champs spécifiés dans ResultFields
. Si aucun enregistrement ne correspond, la méthode appelle Null pour renvoyer un variant null.
Si les champs de recherche dans KeyFields
sont indexés, Lookup utilise l'index. Sinon, Lookup crée un filtre pour la recherche.
Pour un ensemble de données IBDataSet1
et une connexion à la base de données employee.gdb du dossier d'installation Interbase, le code Delphi devrait ressembler à ceci :
var keyfield, keyvalue, resultVariant: Variant;
resultFields:string;
begin
keyfield:='COUNTRY';
keyvalue:='USA';
resultFields:='CURRENCY';
resultvar:=Form1.IBDataSet1.Lookup(keyfield,keyvalue,resultFields);
end;