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);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | IBX.IBCustomDataSet.pas IBX.IBCustomDataSet.hpp |
IBX.IBCustomDataSet | TIBCustomDataSet |
Description
Recherche dans l'ensemble de données l'enregistrement situé après un enregistrement spécifié et le choisit comme enregistrement en cours.
Appelez LocateNext pour rechercher dans un ensemble de données un enregistrement situé après la position en cours du curseur.
KeyFields est une chaîne contenant une liste délimitée par des points-virgules des noms de champs à utiliser pour la recherche.
KeyValues est un variant spécifiant les valeurs à rechercher dans les champs clé. Si KeyFields ne contient qu'un seul nom de champ, KeyValues spécifie la valeur pour ce champ dans l'enregistrement voulu. Pour spécifier plusieurs valeurs de recherche, transmettez un tableau de variants en tant KeyValues, ou construisez un tableau de variants à la volée en utilisant la routine VarArrayOf.
Le paramètre Options est un ensemble qui peut spécifier des caractéristiques de recherche supplémentaires lors d'une recherche dans des champs chaînes. Si Options contient la valeur loCaseInsensitive, LocateNext ignore la casse lors de la comparaison des champs. Si Options contient la valeur loPartialKey, LocateNext autorise les recherches partielles sur des chaînes dans KeyValues. Si Options est un ensemble vide ou si KeyFields ne contient pas de champs chaînes, Options est ignoré.
LocateNext renvoie true si elle trouve un enregistrement correspondant, et elle le sélectionne comme enregistrement en cours. Sinon, LocateNext renvoie false.
LocateNext utilise la méthode la plus rapide possible pour localiser les enregistrements correspondant. Si les champs de recherche dans KeyFields sont indexés et si l'index est compatible avec les options de recherche spécifiées, LocateNext utilise l'index. Sinon, LocateNext crée un filtre pour la recherche.