Mit der Methode Locate können Sie einen Datensatz in der Datenmenge suchen und ihn zum aktuellen Datensatz machen.

Delphi Syntax:

function Locate(const KeyFields: string; const KeyValues: Variant; Options: TLocateOptions): Boolean;

C++ Syntax:

virtual bool __fastcall Locate(const AnsiString KeyFields, const System::Variant &KeyValues, TLocateOptions Options);

Beschreibung

Mit Locate können Sie einen Datensatz in einer Datenmenge suchen und den Cursor auf diesen Datensatz setzen. KeyFields ist ein String mit einer durch Semikolons getrennten Liste der Felder, die durchsucht werden sollen. KeyValues ist ein variantes Array mit den Werten, die in den Schlüsselfeldern gesucht werden sollen. Options ist eine Menge, mit der die Suche in Stringfeldern genauer definiert werden kann. Enthält Options das Flag loCaseInsensitive, berücksichtigt Locate die Groß-/Kleinschreibung nicht. Enthält Options das Flag loPartialKey, werden teilweise Übereinstimmungen in den Strings von KeyValues gesucht. Enthält Options eine leere Menge oder handelt es sich bei der Eigenschaft KeyFields nicht um Stringfelder, wird Options ignoriert. Wird ein übereinstimmender Datensatz gefunden, gibt Locate den Wert True zurück und aktiviert den gefundenen Datensatz. Andernfalls wird False zurückgegeben.