Data.DB.TDataSet.FindFirst

• Übergeordnet: TDataSet

Delphi

function FindFirst: Boolean;

C++

bool __fastcall FindFirst(void);

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:

• Diese Funktion ist nicht für den Modus TFDTable Live-Datenfenster implementiert.
• Um konventionell durch die Datenmenge mit First, Last, Next und Prior zu navigieren.

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

• 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