IBX.IBTable.TIBTable.Locate
Delphi
function Locate(const KeyFields: string; const KeyValues: Variant; Options: TLocateOptions): Boolean; override;
C++
virtual bool __fastcall Locate(const System::UnicodeString KeyFields, const System::Variant &KeyValues, Data::Db::TLocateOptions Options);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | IBX.IBTable.pas IBX.IBTable.hpp |
IBX.IBTable | TIBTable |
Beschreibung
Sucht in der Tabelle nach einem bestimmten Datensatz und macht diesen zum aktuellen Datensatz.
Mit Locate kann eine Datenmenge nach einem bestimmten Datensatz durchsucht und der Cursor auf diesem Datensatz positioniert werden.
KeyFields ist ein String mit den Feldern, die durchsucht werden sollen. Trennen Sie die einzelnen Felder durch ein Semikolon.
KeyValues ist eine Variante mit den Schlüsselwerten. Enthält KeyFields nur ein Feld, gibt KeyValues den Wert dieses Feldes im gewünschten Datensatz an. Gibt es mehrere Schlüsselfelder, übergeben Sie in KeyValues ein variantes Array, das Sie auch zur Laufzeit mithilfe der Routine VarArrayOf erstellen können. Zum Beispiel:
with CustTable do
Locate('Company;Contact;Phone', VarArrayOf(['Sight Diver', 'P', '408-431-1000']), [loPartialKey]);
TLocateOptions Opts;
Opts.Clear();
Opts << loPartialKey;
Variant locvalues[3];
locvalues[0] = Variant("Sight Diver");
locvalues[1] = Variant("P");
locvalues[2] = Variant("408-431-1000");
CustTable->Locate("Company;Contact;Phone", VarArrayOf(locvalues, 2), Opts);
Options ist eine Menge von Flags, mit denen Sie optional weitere Suchkriterien für String-Felder festlegen können. Enthält der Parameter den Wert loCaseInsensitive, findet keine Unterscheidung zwischen Groß- und Kleinschreibung statt. Bei loPartialKey müssen Strings nicht vollständig übereinstimmen. Wenn Options eine leere Menge ist oder KeyFields keine String-Felder enthält, wird der Parameter ignoriert.
Locate gibt true zurück, wenn ein Datensatz gefunden wird. Dieser Datensatz wird außerdem aktiviert. Andernfalls gibt Locate false zurück.
Die Methode verwendet bei der Datensatzsuche die schnellstmögliche Methode. Sind die Suchfelder in KeyFields indiziert und ist der Index mit der angegebenen Suchoption kompatibel, wird der Index verwendet. Andernfalls wird für die Suche ein Filter erstellt.