FireDAC.Comp.DataSet.TFDDataSet.FindNearest

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure FindNearest(const AKeyValues: array of const);

C++

void __fastcall FindNearest(const System::TVarRec *AKeyValues, const int AKeyValues_High);

Propriétés

Type Visibilité  Source Unité  Parent
procedure
function
public
FireDAC.Comp.DataSet.pas
FireDAC.Comp.DataSet.hpp
FireDAC.Comp.DataSet TFDDataSet

Description

Recherche un enregistrement contenant les valeurs de champs d'index spécifié.

Utilisez FindNearest pour rechercher l'enregistrement dans un ensemble de données indexé, en utilisant des valeurs de champs d'index spécifié.

AKeyValues est un tableau ouvert contenant des valeurs de champs représentant une clé. Chaque valeur de la clé peut être un littéral, une variable ou nil. Si le nombre de valeurs passées dans AKeyValues est inférieur au nombre de colonnes de l'index utilisé pour la recherche, les valeurs manquantes sont supposées être nil.

Si une recherche réussit, FindNearest positionne le curseur sur l'enregistrement correspondant et renvoie True. Sinon, il positionne le curseur sur l'enregistrement qui est supérieur à la clé spécifiée.

Exemple

 FDQuery1.IndexFieldNames := 'F1;F2';
 FDQuery1.FindNearest([100, 'qwe']);

Voir aussi