Datasnap.DBClient.TCustomClientDataSet.FindNearest
Delphi
procedure FindNearest(const KeyValues: array of const);
C++
void __fastcall FindNearest(const System::TVarRec *KeyValues, const int KeyValues_High);
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
procedure function |
public | Datasnap.DBClient.pas Datasnap.DBClient.hpp |
Datasnap.DBClient | TCustomClientDataSet |
Beschreibung
Bewegt den Cursor zu dem Datensatz, der einem angegebenen Satz von Schlüsselwerten an besten entspricht.
Mit FindNearest kann der Cursor zu einem bestimmten Datensatz in einer Datenmenge verschoben werden bzw. zum ersten Datensatz, der den im Parameter KeyValues
angegebenen Werten entspricht oder größer ist. Existieren keine Datensätze, die dem angegebenen Kriterium entsprechen oder dieses übersteigen, positioniert FindNearest den Cursor auf dem letzten Datensatz der Tabelle. Die Eigenschaft KeyExclusive legt fest, ob übereinstimmende Werte berücksichtigt werden.
KeyValues
enthält ein Array von Feldwerten, die durch Kommas voneinander getrennt sind. Das Array wird Schlüssel genannt. Ist die Anzahl der in KeyValues
übergebenen Werte kleiner als die Anzahl der Spalten im Index, der für die Suche verwendet wird, werden die fehlenden Werte als NULL unterstellt KeyValues_Size gibt in C++ den Index des letzten Wertes im Array KeyValues
an. Der Wert ist um eins kleiner als die Anzahl der Schlüsselwerte.
Anmerkung: FindNearest kann nur für String-Datentypen verwendet werden.