FireDAC.Comp.DataSet.TFDDataSet.GotoKey

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function GotoKey: Boolean;

C++

bool __fastcall GotoKey();

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, en utilisant les valeurs du tampon de clé.

Utilisez GotoKey pour rechercher un enregistrement en utilisant les valeurs assignées aux champs indexés après un appel précédent de SetKey/EditKey.

Avant l'appel, l'ensemble de données doit être dans l'état dsSetKey. Si GotoKey trouve un enregistrement, il en fait l'enregistrement en cours dans l'ensemble de données et renvoie True. Sinon, la position en cours reste inchangée et GotoKey renvoie False.

Exemple

 FDQuery1.IndexFieldNames := 'CUSTOMER_ID;ORDER_DATE';
 FDQuery1.SetKey;
 FDQuery1.FieldByName('CUSTOMER_ID').AsInteger := 100;
 FDQuery1.FieldByName('ORDER_DATE').AsDateTime := EncodeDate(2008, 5, 1);
 if not FDQuery1.GotoKey then
   ShowMesage('Order is not found');

Voir aussi