TurboDB VCL/CLX Komponenten Bibliothek
TTdbDataSet.Locate
TTdbDataSet
Top 


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

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

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 Kommas 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.