Find, méthode (ADO)
S’applique à : Access 2013, Office 2013
Recherche un objet Recordset pour la ligne qui répond aux critères spécifiés. Il est éventuellement possible de spécifier des paramètres facultatifs, tels que la direction de la recherche, la ligne de début et un décalage par rapport à la ligne de début. Si les critères sont satisfaits, la position de ligne actuelle est définie sur l’enregistrement identifié ; sinon la position est définie à la fin (ou au début) de l’objet Recordset.
Syntaxe
Find (Criteria, SkipRows, SearchDirection, Start)
Paramètres
| Paramètre | Description |
|---|---|
| Critères | Une valeur de type String qui contient une instruction spécifiant le nom de colonne, l'opérateur de comparaison et la valeur à utiliser dans la recherche. |
| SkipRows | Optional. Valeur de type Long, dont la valeur par défaut est zéro et qui spécifie le décalage de lignes par rapport à la ligne active ou un signet Start à partir duquel commencer la recherche. Par défaut, la recherche commence à partir de la ligne active. |
| SearchDirection | Optional. Valeur SearchDirectionEnum qui spécifie si la recherche doit commencer à partir de la ligne active ou de la ligne disponible suivante selon la direction de la recherche. Une recherche qui ne donne aucun résultat s'arrête à la fin de l'objet Recordset si la valeur est adSearchForward. En revanche, elle s'arrête au début de l'objet Recordset si la valeur est adSearchBackward. |
| Début | Facultatif. Signet de type Variant qui indique la position de début de la recherche. |
Remarques
Un seul nom de colonne peut être spécifié dans Critères. Cette méthode ne prend pas en charge les recherches dans plusieurs colonnes.
L’opérateur de comparaison dans Critères peut être «> » (supérieur à), «< » (inférieur à), « = » (égal), «> = » (supérieur ou égal à), «< = » (inférieur ou égal), «<> » (différent) ou « j’aime » (correspondance de modèle).
La valeur figurant dans Critères peut être une chaîne, un nombre à virgule flottante ou une date. Les valeurs de chaîne sont délimitées par des guillemets simples ou des signes « # » (dièse) (par exemple, « state = 'WA' » ou « state = #WA# »). Les valeurs de date sont délimitées par des marques « # » (signe numérique) (par exemple, « start_date > #22/7/97# ») et peuvent contenir des heures, des minutes et des secondes pour indiquer des horodatages, mais ne doivent pas contenir de millisecondes ou des erreurs se produisent.
Si l'opérateur de comparaison est « like », la valeur de la chaîne peut contenir un astérisque (*) pour rechercher une ou plusieurs occurrences d'un caractère ou d'une sous-chaîne. Par exemple, « state like 'M*' » correspond à Maine et Massachusetts. Vous pouvez également utiliser des astérisques au début et à la fin pour rechercher une sous-chaîne dans les valeurs. Par exemple, « state like '*as* » correspond à Alaska, Arkansas et Massachusetts.
Les astérisques peuvent uniquement être utilisés à la fin d'une chaîne de critères ou au début et à la fin de celle-ci, comme illustré ci-dessus. Vous ne pouvez pas l'employer comme caractère générique de début ('*str') ou incorporé ('s*r'). Cela provoque une erreur.
Remarque
[!REMARQUE] Une erreur se produit si la position de ligne actuelle n'est pas définie avant d'appeler Find. Toute méthode qui définit la position de ligne, par exemple MoveFirst, doit être appelée avant la méthode Find.
Remarque
[!REMARQUE] Si vous appelez la méthode Find sur un jeu d'enregistrements et que la position actuelle dans le jeu d'enregistrements correspond au dernier enregistrement ou à la fin du fichier (EOF), votre recherche ne donne aucun résultat. Vous devez appeler la méthode MoveFirst pour définir la position/le curseur actuel au début du jeu d'enregistrements.