Datasnap.DBClient.TCustomClientDataSet.FindKey
Delphi
function FindKey(const KeyValues: array of const): Boolean; virtual;
C++
virtual bool __fastcall FindKey(const System::TVarRec *KeyValues, const int KeyValues_High);
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | Datasnap.DBClient.pas Datasnap.DBClient.hpp |
Datasnap.DBClient | TCustomClientDataSet |
Description
Recherche un enregistrement dont les champs contiennent les valeurs spécifiées.
La méthode FindKey permet de rechercher un enregistrement spécifique d'un ensemble de données. KeyValues contient un tableau délimité par des virgules de valeurs de champ, appelé une clé. Chaque valeur de la clé peut être un littéral, une variable, nil (Delphi) ou NULL (C++). Si le nombre de valeurs transmises dans KeyValues est inférieur au nombre de colonnes de l'index utilisé pour la recherche, les valeurs manquantes sont supposées être NULL. Dans le cas de C++, KeyValues_Size indique l'index de la dernière valeur du tableau KeyValues. Il s'agit du nombre de valeurs de clé moins une.
Si la recherche réussit, FindKey positionne le curseur sur l'enregistrement correspondant et renvoie true. Sinon, le curseur n'est pas déplacé et FindKey renvoie false.