function Locate

Syntax:

function locate(const KeyFields: string; const KeyValues: variant; Options: TLocateOptions): boolean;

Beschreibung:

Die Methode Locate implementiert eine virtuelle Methode, um in der Datenmenge nach einem bestimmten Datensatz zu suchen und diesen zum aktiven Datensatz zu machen.

Diese Methode führt folgende Aktionen durch:

Sie überprüft, ob es sich um eine unidirektionale Datenmenge handelt. Ist dies der Fall, wird eine EDatabaseError-Exception ausgelöst. Sie gibt false zurück, wenn kein übereinstimmender Datensatz gefunden und der aktive Datensatz nicht gewechselt wurde.

Abgeleitete Klassen (mit Ausnahme unidirektionaler Datenmengen) überschreiben Locate, um nach dem Datensatz zu suchen, in dem die in KeyFields übergebenen durch Semikolon getrennten Felder die durch KeyValues angegebenen Werte haben (KeyValues ist eine Variante bzw. ein variantes Array). Mit Options können Suchoptionen festgelegt werden (Groß-/Kleinschreibung und Teilübereinstimmung). Locate gibt true zurück, wenn der gesuchte Datensatz gefunden und aktiviert wurde.
Beispiel: