Data.SqlExpr.TCustomSQLDataSet.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 | Data.SqlExpr.pas Data.SqlExpr.hpp |
Data.SqlExpr | TCustomSQLDataSet |
Description
Implémente une méthode virtuelle pour récupérer la valeur de champs donnés d'un enregistrement contenant les valeurs recherchées.
Cette fonction :
Vérifie si l'ensemble de données est unidirectionnel et dans ce cas, déclenche une exception EDatabaseError.
Renvoie un Variant ayant la valeur false, ce qui indique qu'un enregistrement correspondant n'a pas été trouvé.
Les classes descendantes qui ne sont pas unidirectionnelles redéfinissent cette méthode afin de localiser l'enregistrement dont les champs identifiés par la chaîne de KeyFields (séparés par des virgules) ont les valeurs spécifiées par KeyValues. Dans les classes implémentant Lookup, cette fonction renvoie un Variant ou un tableau de Variants contenant la valeur ou les valeurs des champs spécifiés par la chaîne ResultFields, séparées par des virgules, sur l'enregistrement spécifié.