API:Bde.DBTables.TBDEDataSet.Locate
Delphi
function Locate(const KeyFields: string; const KeyValues: Variant; Options: TLocateOptions): Boolean; override;
C++
virtual bool __fastcall Locate(const System::UnicodeString KeyFields, const System::Variant &KeyValues, Data::Db::TLocateOptions Options);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | Bde.DBTables.pas Bde.DBTables.hpp |
Bde.DBTables | TBDEDataSet |
Description
Implémente une méthode virtuelle pour rechercher dans l'ensemble de données l'enregistrement spécifié et en faire l'enregistrement actif.
Bde.DBTables.TBDEDataSet.Locate hérite de Data.DB.TDataSet.Locate. Tout le contenu en-dessous de cette ligne se réfère à Data.DB.TDataSet.Locate.
Implémente une méthode virtuelle pour rechercher dans l'ensemble de données l'enregistrement spécifié et en faire l'enregistrement actif.
Cette fonction :
Vérifie si l'ensemble de données est unidirectionnel et dans ce cas, déclenche une exception EDatabaseError.
Renvoie false, ce qui indique qu'un enregistrement correspondant n'a pas été trouvé et que l'enregistrement actif n'a pas été changé.
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 liste de champs (séparés par des points-virgules) de KeyFields ont les valeurs spécifiées par KeyValues. Options indique si la recherche ne distingue pas les majuscules des minuscules et si des correspondances partielles sont supportées. Locate renvoie true si un enregistrement répondant aux critères spécifiés est trouvé et que l'enregistrement est maintenant actif.