Find, méthode (ADO)

Recherche un Recordset pour la ligne qui répond aux critères spécifiés. Si vous le souhaitez, la direction de la recherche, la ligne de départ et le décalage de la ligne de départ peuvent être spécifiées. Si les critères sont remplis, la position de ligne actuelle est définie sur l’enregistrement trouvé ; sinon, la position est définie sur la fin (ou le début) du Recordset.

Syntaxe

  
Find (Criteria, SkipRows, SearchDirection, Start)  

Paramètres

Critères
Valeur Chaîne qui contient une instruction spécifiant le nom de colonne, l’opérateur de comparaison et la valeur à utiliser dans la recherche.

SkipRows
facultatif. Valeur longue , dont la valeur par défaut est zéro, qui spécifie le décalage de ligne de la ligne active ou du signet Démarrer pour commencer la recherche. Par défaut, la recherche démarre sur la ligne active.

SearchDirection
facultatif. Valeur SearchDirectionEnum qui spécifie si la recherche doit commencer sur la ligne active ou la ligne suivante disponible dans la direction de la recherche. Une recherche infructueuse s’arrête à la fin de l’objet Recordset si la valeur est adSearchForward. Une recherche infructueuse s’arrête au début de l’objet Recordset si la valeur est adSearchBackward.

Start
facultatif. Signet Variant qui fonctionne comme position de départ pour la recherche.

Notes

Seul un nom à une seule colonne peut être spécifié dans les critères. Cette méthode ne prend pas en charge les recherches à 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 égal) ou « like » (correspondance de modèle).

La valeur 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 « # » (signe numérique) (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 > #7/22/97# »). Ces valeurs peuvent contenir des heures, des minutes et des secondes pour indiquer des horodatages, mais ne doivent pas contenir de millisecondes ou d’erreurs.

Si l’opérateur de comparaison est « like », la valeur de chaîne peut contenir un astérisque (*) pour rechercher une ou plusieurs occurrences de n’importe quel caractère ou sous-chaîne. Par exemple, « state like 'M*' » correspond à Maine et Massachusetts. Vous pouvez également utiliser des astérisque de début et de fin pour rechercher une sous-chaîne contenue dans les valeurs. Par exemple, « state like '*as*' correspond à Alaska, Arkansas et Massachusetts.

Les astérisque peuvent être utilisés uniquement à la fin d’une chaîne de critères, ou à la fois au début et à la fin d’une chaîne de critères, comme indiqué ci-dessus. Vous ne pouvez pas utiliser l’astérisque comme caractère générique de début ('*str') ou comme caractère générique incorporé ('s*r'). Cela entraîne une erreur.

Notes

Une erreur se produit si une position de ligne actuelle n’est pas définie avant d’appeler Trouver. Toute méthode qui définit la position de ligne, telle que MoveFirst, doit être appelée avant d’appeler Trouver.

Notes

Si vous appelez la méthode Trouver sur un jeu d’enregistrements et que la position actuelle dans le jeu d’enregistrements est au dernier enregistrement ou à la fin du fichier (EOF), vous ne trouverez rien. Vous devez appeler la méthode MoveFirst pour définir la position/le curseur actuel au début du jeu d’enregistrements.

S'applique à

Recordset, objet (ADO)

Voir aussi

Find, exemple de méthode (VB)
Index, propriété
Optimize, propriété dynamique (ADO)
Seek, méthode