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.