IBX.IBCustomDataSet.TIBCustomDataSet.LocateNext
Delphi
function LocateNext(const KeyFields: string; const KeyValues: Variant; Options: TLocateOptions): Boolean;
C++
bool __fastcall LocateNext(const System::UnicodeString KeyFields, const System::Variant &KeyValues, Data::Db::TLocateOptions Options);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | IBX.IBCustomDataSet.pas IBX.IBCustomDataSet.hpp |
IBX.IBCustomDataSet | TIBCustomDataSet |
Beschreibung
Durchsucht die Datenmenge nach einem Datensatz, der auf einen angegebenen Datensatz folgt, und macht ihn zum aktuellen Datensatz.
Mit LocateNext können Sie in der Datenmenge nach einem Datensatz hinter der aktuellen Cursorposition suchen.
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.
Der Parameter Options gibt optional weitere Suchmöglichkeiten für die Suche in String-Feldern an. 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.
Wenn ein Datensatz gefunden wurde, gibt LocateNext True zurück und macht den Datensatz zum aktuellen Datensatz. Andernfalls wird False zurückgegeben.
LocateNext verwendet das schnellste Verfahren zum Auffinden von Datensätzen. 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.