Méthode DoCmd.SetParameter (Access)
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.