Data.DB.TDataSet.Locate

• Übergeordnet: TDataSet

Delphi

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

C++

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

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	Data.DB.pas Data.DB.hpp	Data.DB	TDataSet

Beschreibung

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.

Siehe auch

• FindField

• Lookup

• Datensätze über Indizes suchen

• Die Methode Locate