Data.DB.TDataSet.FindFirst
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 :
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());
}