Data.DB.TDataSet.FindFirst

• Aller au parent : TDataSet

Delphi

function FindFirst: Boolean;

C++

bool __fastcall FindFirst();

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	Data.DB.pas Data.DB.hpp	Data.DB	TDataSet

Description

Implémente une méthode virtuelle positionnant l'ensemble de données sur le premier enregistrement, en respectant les filtres.

FindFirst est censée être utilisée avec FindNext, FindLast et FindPrior afin de rechercher le premier enregistrement en utilisant n'importe quel filtre. Voir l'exemple.

Remarques :

• Cette fonction n'est pas implémentée pour le mode Fenêtres Données dynamiques de TFDTable.
• Pour naviguer de manière conventionnelle dans un ensemble de données, utilisez First, Last, Next et Prior.

Les classes descendantes redéfinissent FindFirst pour rendre le premier enregistrement actif, honorant tous les filtres actifs. Dans les classes descendantes, FindFirst renvoie :

• True -- si l'enregistrement actif a été modifié avec succès.
• False -- si l'enregistrement actif n'a pas été modifié avec succès.

Exemple

Voici un extrait de code montrant l'utilisation de FindFirst et de FindNext pour chercher un enregistrement en utilisant une expression de filtrage :

Delphi :

FDQuery1.Filter := 'amount >= 10000';
if FDQuery1.FindFirst then
   repeat
    // do something
   until not FDQuery1.FindNext;

C++ :

FDQuery1->Filter="amount >= 10000";
if (FDQuery1->FindFirst()){
   do {
    // do something
   }
   while (FDQuery1->FindNext());
}

Voir aussi

• Data.DB.TDataSet.Filter
• Data.DB.TDataSet.Filtered
• Data.DB.TDataSet.OnFilterRecord
• Data.DB.TDataSet.FindLast
• Data.DB.TDataSet.FindNext
• Data.DB.TDataSet.FindPrior
• Data.DB.TDataSet.First