FireDAC.Comp.DataSet.TFDDataSet.FindKey

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function FindKey(const AKeyValues: array of const): Boolean;

C++

bool __fastcall FindKey(const System::TVarRec *AKeyValues, const int AKeyValues_High);

Propriétés

Type Visibilité  Source Unité  Parent
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 FindKey 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, FindKey positionne le curseur sur l'enregistrement correspondant et renvoie True. Sinon, le curseur n'est pas déplacé et FindKey renvoie False.

Exemple

 FDQuery1.IndexFieldNames := 'F1;F2';
 if not FDQuery1.FindKey([100, 'qwe']) then
   ShowMessage('100;qwe is not found');

Voir aussi