Data.DB.TDataSet.FindFirst

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function FindFirst: Boolean;

C++

bool __fastcall FindFirst();

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Data.DB.pas
Data.DB.hpp
Data.DB TDataSet


Beschreibung

Implementiert eine virtuelle Methode, die unter Berücksichtigung aller Filter den ersten Datensatz einer Datenmenge aktiviert.

FindFirst wird zusammen mit FindNext, FindLast und FindPrior verwendet, um mit allen Filtern nach dem ersten Datensatz zu suchen. Siehe das Beispiel.

Hinweise:

Abgeleitete Klassen überschreiben FindFirst, um den ersten Datensatz, mit Berücksichtigung auf alle wirksamen Filter, zu aktivieren. Bei abgeleiteten Klassen gibt FindFirst folgendes zurück:

  • True -- wenn der aktive Datensatz erfolgreich geändert wurde.
  • False -- wenn der aktive Datensatz ohne Erfolg geändert wurde.

Beispiel

Hier ist ein Codefragment, das zeigt, wie FindFirst und FindNext verwendet werden, um nach einem Datensatz mit einem Filterausdruck zu suchen:

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());
}

Siehe auch