FireDAC.Comp.DataSet.TFDDataSet.FindNearest

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure FindNearest(const AKeyValues: array of const);

C++

void __fastcall FindNearest(const System::TVarRec *AKeyValues, const int AKeyValues_High);

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 Datensatz, der die angegebenen Indexfeldwerte enthält.

Mit FindNearest suchen Sie nach einem Datensatz in einer indizierten Datenmenge anhand der angegebenen Indexfeldwerte.

AKeyValues ist ein offenes Array, das die Feldwerte (Schlüssel) enthält. Jeder Wert im Schlüssel kann ein Literal, eine Variable oder nil sein. Wenn die in AKeyValues übergebene Anzahl der Werte kleiner als die Anzahl der Spalten des für die Suche verwendeten Index ist, wird für die fehlenden Werte nil angenommen.

Wenn eine Suche erfolgreich ist, setzt FindNearest den Cursor auf den übereinstimmenden Datensatz und gibt True zurück. Ansonsten wird der Cursor auf den Datensatz gesetzt, der größer als der angegebene Schlüssel ist.

Beispiel

 
 FDQuery1.IndexFieldNames := 'F1;F2';
 FDQuery1.FindNearest([100, 'qwe']);

Siehe auch