Méthode DoCmd.SetParameter (Access)

  • Article

Utilisez la méthode SetParameter pour créer un paramètre à utiliser par les méthodes BrowseTo, OpenForm, OpenQuery, OpenReport ou RunDataMacro .

Syntaxe

expression. SetParameter (Name, Expression)

expressionune variable représentant un objet DoCmd.

Paramètres

Nom Requis/Facultatif Type de données Description
Name Obligatoire Variant Le nom du paramètre. Le nom doit correspondre au nom du paramètre attendu par BrowseTo, OpenForm, OpenQuery, OpenReport ou méthode RunDataMacro.
Expression Obligatoire Variant Expression qui donne une valeur à affecter au paramètre.

Remarques

Vous devez créer autant d'appels à la méthode SetParameter que nécessaire pour créer les paramètres que vous avez besoin.

Chaque appel à SetParameter ajoute ou met à jour un paramètre unique dans une collection de paramètres interne. La collection de paramètres est transmise à BrowseTo, OpenForm, OpenQuery, OpenReport ou méthode RunDataMacro. Lorsque la méthode est exécutée, la collection de paramètres fournit les paramètres nécessaires. Une fois la méthode terminée, la collection de paramètres est effacée.

Étant donné que chacune de ces méthodes qui accepte les paramètres efface la collection parameters lorsqu'elle est terminée, vous devez vous assurer que vos appels SetParameter précèdent immédiatement l'appel à la méthode qui les emploie.

Exemple

L'exemple de code suivant crée deux paramètres pour la macro de données AddComment. Les deux paramètres sont appelés prmComment et prmRelatedID, respectivement. La valeur de la zone de texte txtComment est stockée dans le paramètre prmComment. La valeur de la zone de texte txtId est stockée dans le paramètre prmRelatedID.

Private Sub cmdAddComment_Click() 
DoCmd.SetParameter "prmComment", Me.txtComment 
DoCmd.SetParameter "prmRelatedID", Me.txtId 
DoCmd.RunDataMacro "Comments.AddComment" 
End Sub

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.