API:Bde.DBTables.TBDEDataSet.Locate

• Übergeordnet: TBDEDataSet

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	Bde.DBTables.pas Bde.DBTables.hpp	Bde.DBTables	TBDEDataSet

Beschreibung

Implementiert eine virtuelle Methode, um in der Datenmenge nach einem bestimmten Datensatz zu suchen und diesen zum aktiven Datensatz zu machen.

Bde.DBTables.TBDEDataSet.Locate erbt von Data.DB.TDataSet.Locate. Der folgende Inhalt bezieht sich auf Data.DB.TDataSet.Locate.

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