API:Data.SqlExpr.TCustomSQLDataSet.Lookup

De RAD Studio API Documentation
Aller à : navigation, rechercher

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.

Data.SqlExpr.TCustomSQLDataSet.Lookup hérite de Data.DB.TDataSet.Lookup. Tout le contenu en-dessous de cette ligne se réfère à Data.DB.TDataSet.Lookup.

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é.

Voir aussi