Find, méthode (ADO)
Recherche une 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 jeu d’enregistrements .
Syntaxe
Find (Criteria, SkipRows, SearchDirection, Start)
Paramètres
critères
Valeur string qui contient une instruction spécifiant le nom de colonne, l’opérateur de comparaison et la valeur à utiliser dans la recherche.
SkipRows
Optionnel. Valeur long, dont la valeur par défaut est égale à zéro, qui spécifie le décalage de ligne de la ligne active ou Début signet pour commencer la recherche. Par défaut, la recherche démarre sur la ligne active.
searchDirection
Optionnel. 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 du jeu d’enregistrements si la valeur est adSearchForward. Une recherche infructueuse s’arrête au début du jeu d’enregistrements si la valeur est adSearchBackward.
démarrer
Optionnel. Un Variant signet qui fonctionne comme position de départ pour la recherche.
Remarques
Seul un nom à colonne unique peut être spécifié dans 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 « 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 des marques de signe numérique (par exemple, « state = 'WA' » ou « state = #WA# »). Les valeurs de date sont délimitées par des marques de signe numérique (par exemple, « start_date > #7/22/97# »). Ces valeurs peuvent contenir des heures, des minutes et des secondes pour indiquer les 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 au Maine et au Massachusetts. Vous pouvez également utiliser des astérisques 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érisques ne peuvent être utilisés qu’à 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.
Note
Une erreur se produit si une position de ligne actuelle n’est pas définie avant d’appeler Rechercher. Toute méthode qui définit la position de ligne, telle que MoveFirst, doit être appelée avant d’appeler Rechercher.
Note
Si vous appelez la méthode Find 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 à
Voir aussi
Find, méthode - Exemple (VB)
Index, propriété
Optimiser Property-Dynamic (ADO)
méthode Seek