FireDAC.Comp.DataSet.TFDDataSet.GotoKey

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function GotoKey: Boolean;

C++

bool __fastcall GotoKey();

Eigenschaften

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

Beschreibung

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

Mit GotoKey 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 GotoKey einen Datensatz findet, wird er zum aktuellen Datensatz in der Datenmenge, und die Methode gibt True zurück. Ansonsten bleibt die aktuelle Position unverändert, und GotoKey gibt False zurück.

Beispiel

 
 FDQuery1.IndexFieldNames := 'CUSTOMER_ID;ORDER_DATE';
 FDQuery1.SetKey;
 FDQuery1.FieldByName('CUSTOMER_ID').AsInteger := 100;
 FDQuery1.FieldByName('ORDER_DATE').AsDateTime := EncodeDate(2008, 5, 1);
 if not FDQuery1.GotoKey then
   ShowMesage('Order is not found');

Siehe auch