Datasnap.DBClient.TCustomClientDataSet.FindNearest
Delphi
procedure FindNearest(const KeyValues: array of const);
C++
void __fastcall FindNearest(const System::TVarRec *KeyValues, const int KeyValues_High);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
procedure function |
public | Datasnap.DBClient.pas Datasnap.DBClient.hpp |
Datasnap.DBClient | TCustomClientDataSet |
Description
Déplace le curseur sur l'enregistrement le plus proche d'un ensemble spécifié de valeurs clé.
La méthode FindNearest permet de déplacer le curseur sur un enregistrement spécifique d'un ensemble de données ou sur le premier enregistrement de l'ensemble de données contenant des valeurs correspondant ou supérieures à celles spécifiées dans le paramètre KeyValues. Si aucun enregistrement ne contient de valeurs supérieures ou égales aux critères spécifiés, FindNearest positionne le curseur sur le dernier enregistrement de la table. La propriété KeyExclusive détermine si les valeurs correspondantes sont prises en compte.
KeyValues contient un tableau délimité par des virgules de valeurs de champ, appelé une clé. 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 spécifie l'index de la dernière valeur du tableau KeyValues. Il s'agit du nombre de valeurs de clé moins une.
Remarque : FindNearest ne fonctionne qu'avec les types de données chaîne.