Bde.DBTables.TTable.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
Bde.DBTables.pas
Bde.DBTables.hpp
Bde.DBTables TTable


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. Existieren keine Datensätze, die dem angegebenen Kriterium entsprechen oder dieses übersteigen, positioniert GotoNearest den Cursor auf dem letzten Datensatz der Tabelle.

Vor dem Aufruf von GotoNearest muss die Anwendung Schlüsselwerte festlegen. Dies erfolgt durch den Aufruf von SetKey oder EditKey, um der Datenmenge den Status dsSetKey zuzuweisen. Mit der Methode FieldByName wird anschließend der Schlüsselpuffer mit Werten gefüllt.

Bei Paradox- und dBASE-Tabellen muss der Schlüsselwert immer einen Index darstellen, der in der Eigenschaft IndexName angegeben werden kann. Wenn für IndexName kein Wert angegeben wurde, verwendet GotoNearest den Primärindex der Tabelle. GotoNearest kann mit dBASE-Ausdrucksindizes verwendet werden.

Bei SQL-Tabellen kann der Schlüsselwert einem in IndexName angegebenen Index oder einer in der Eigenschaft IndexFieldNames angegebenen Liste von Feldnamen entsprechen.

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

Siehe auch