Méthode DoCmd.FindRecord (Access)
La méthode FindRecord exécute l’action RechercherEnregistrement dans Visual Basic.
Syntaxe
expression. FindRecord (FindWhat, Match, MatchCase, Search, SearchAsFormatted, OnlyCurrentField, FindFirst)
expressionune variable représentant un objet DoCmd.
Paramètres
| Nom | Requis/Facultatif | Type de données | Description |
|---|---|---|---|
| FindWhat | Obligatoire | Variante | Expression dont le résultat est du texte, un nombre ou une date. L'expression contient les données à rechercher. |
| Match | Facultatif | AcFindMatch | Constante AcFindMatch qui spécifie où rechercher la correspondance. La valeur par défaut est acEntire. |
| MatchCase | Facultatif | Variant | Utilisez la valeur True si la recherche distingue les majuscules des minuscules et False dans le cas contraire. Si vous laissez cet argument vide, la valeur par défaut (False) est supposée. |
| Recherche | Facultatif | AcSearchDirection | Constante AcSearchDirection qui spécifie le sens de la recherche. La valeur par défaut est acSearchAll. |
| SearchAsFormatted | Facultatif | Variant | Utilisez True pour rechercher des données telles qu’elles sont mises en forme et False pour rechercher des données telles qu’elles sont enregistrées dans la base de données. Si vous laissez cet argument vide, la valeur par défaut (False) est supposée. |
| OnlyCurrentField | Facultatif | AcFindField | Constante AcFindField qui spécifie s’il faut rechercher tous les champs ou uniquement le champ actif. La valeur par défaut est acCurrent. |
| FindFirst | Facultatif | Variant | Utilisez True pour commencer la recherche au niveau du premier enregistrement. Utilisez False pour commencer la recherche au niveau de l’enregistrement suivant l’enregistrement actif. Si vous laissez cet argument vierge, la valeur par défaut (True) est choisie. |
Remarques
Lorsqu’une procédure appelle la méthode FindRecord , Access recherche les données spécifiées dans les enregistrements (l’ordre de la recherche est déterminé par le paramètre de l’argument Search ). Lorsqu'Access trouve les données, elles sont sélectionnées dans l'enregistrement.
La méthode FindRecord ne renvoie pas de valeur indiquant sa réussite ou son échec. Pour déterminer si une valeur existe dans un recordset, utilisez la méthode FindFirst, FindNext, FindPrevious ou FindLast de l’objet Recordset . Ces méthodes définissent la valeur de la propriété NoMatch sur True si la valeur spécifiée est introuvable.
Exemple
Cet exemple recherche la première occurrence dans les enregistrements du nom Smith dans le champ actif. Il ne trouve pas les occurrences smith ou Smithson.
DoCmd.FindRecord "Smith",, True,, True
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.