Anzeigen: Delphi C++
Anzeigeeinstellungen

Datasnap.DBClient.TCustomClientDataSet.FindNearest

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure FindNearest(const KeyValues: array of const);

C++

void __fastcall FindNearest(const System::TVarRec *KeyValues, const int KeyValues_High);

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.

Siehe auch

Codebeispiele

Meine Werkzeuge
Übersetzungen
Assistenz