FireDAC.Comp.DataSet.TFDDataSet.GotoNearest

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure GotoNearest;

C++

void __fastcall GotoNearest();

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
FireDAC.Comp.DataSet.pas
FireDAC.Comp.DataSet.hpp
FireDAC.Comp.DataSet TFDDataSet

Beschreibung

Sucht nach einem nächstgelegenen Datensatz anhand der Werte im Schlüsselpuffer.

Mit GotoNearest suchen Sie einen Datensatz anhand der Werte, die den indizierten Feldern nach einem vorausgehenden Aufruf von SetKey/EditKey zugewiesen wurden.

Vor dem Aufruf muss sich die Datenmenge im Status dsSetKey befinden. Wenn GotoNearest einen Datensatz findet, wird er zum aktuellen Datensatz in der Datenmenge. Ansonsten wird der erste Datensatz mit größeren Werten als die angegebenen Werte zum aktuellen Datensatz in der Datenmenge.

Beispiel

 
 FDQuery1.IndexFieldNames := 'CUSTOMER_ID;ORDER_DATE';
 FDQuery1.SetKey;
 FDQuery1.FieldByName('CUSTOMER_ID').AsInteger := 100;
 FDQuery1.FieldByName('ORDER_DATE').AsDateTime := EncodeDate(2008, 5, 1);
 FDQuery1.GotoNearest;

Siehe auch