Data.Win.ADODB.TCustomADODataSet.Locate

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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
Data.Win.ADODB.pas
Data.Win.ADODB.hpp
Data.Win.ADODB TCustomADODataSet

Beschreibung

Durchsucht die Datenmenge nach einem bestimmten Datensatz und macht ihn zum aktuellen Datensatz.

Mit Locate können Sie in der Datenmenge nach einem bestimmten Datensatz suchen und den Satzzeiger darauf positionieren.

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. Wenn es nur ein Schlüsselfeld gibt, enthält KeyValues einfach den entsprechenden Suchwert. Gibt es mehrere Schlüsselfelder, übergeben Sie in KeyValues ein variantes Array, das Sie auch zur Laufzeit mithilfe der Routine VarArrayOf erstellen können. Ein Beispiel:



with ADOTable1 do
Locate('Company;Contact;Phone', VarArrayOf(['Sight Diver', 'P', '408-431-1000']), [loPartialKey]);



TLocateOptions Opts;
Opts.Clear();
Opts << loPartialKey;
Variant locvalues[2];
locvalues[0] = Variant("Sight Diver");
locvalues[1] = Variant("P");
CustTable->Locate("Company;Contact", VarArrayOf(locvalues, 1), 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.

Siehe auch