Datasnap.DBClient.TCustomClientDataSet.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
Datasnap.DBClient.pas
Datasnap.DBClient.hpp
Datasnap.DBClient TCustomClientDataSet

Beschreibung

Verschiebt den Cursor auf den Datensatz, der dem aktuellen Schlüssel am besten entspricht.

Mit GotoNearest kann der Cursor auf dem Datensatz positioniert werden, der entweder den aktuellen Schlüsselwerten im Schlüsselpuffer exakt entspricht, oder auf dem ersten Datensatz, der diese Werte überschreitet. Ist kein Datensatz vorhanden, der dem angegebenen Kriterium entspricht oder es überschreitet, positioniert GotoNearest den Cursor auf dem letzten Datensatz in der Datenmenge.

Anmerkung:  Die Eigenschaft KeyExclusive bestimmt, welche Datensätze als Teil des Suchbereichs betrachtet werden.

Vor dem Aufruf von GotoNearest muss die Anwendung durch Aufruf von SetKey oder EditKey Schlüsselwerte festlegen und der Datenmenge den Status dsSetKey zuweisen und den Puffer anschließend über FieldByName mit Suchwerten füllen.

Siehe auch