DoCmd パラメーターメソッド (Access)DoCmd.SetParameter method (Access)

BrowseToOpenFormOpenQueryOpenReport、または**RunDataMacro** メソッドで使用するパラメーターを作成するには、 setparameterメソッドを使用します。Use the SetParameter method to create a parameter for use by the BrowseTo, OpenForm, OpenQuery, OpenReport, or RunDataMacro methods.

構文Syntax

setparameter(名前)expression.SetParameter (Name, Expression)

expression: DoCmd オブジェクトを表す変数。expression A variable that represents a DoCmd object.

パラメーターParameters

名前Name 必須 / オプションRequired/Optional データ型Data type 説明Description
名前Name 必須Required VariantVariant パラメーター名。The name of the parameter. この名前は、BrowseTo メソッド、OpenForm メソッド、OpenQuery メソッド、OpenReport メソッド、または RunDataMacro メソッドで必要なパラメーターの名前と一致している必要があります。The name must match the name of the parameter expected by the BrowseTo, OpenForm, OpenQuery, OpenReport, or RunDataMacro method.
ExpressionExpression 必須Required VariantVariant パラメーターに割り当てる値を求める式。An expression that evaluates to a value to assign to the parameter.

注釈Remarks

作成するパラメーターの数だけ、SetParameter メソッドを呼び出す必要があります。You must create as many calls to the SetParameter method as are necessary to create the parameters you need.

SetParameter を 1 回呼び出すたびに、内部パラメーター コレクションに 1 つのバラメーターが追加されるか、または 1 つのパラメーターが更新されます。Each call to SetParameter adds or updates a single parameter in an internal parameters collection. パラメーター コレクションは、BrowseTo メソッド、OpenForm メソッド、OpenQuery メソッド、OpenReport メソッド、または RunDataMacro メソッドに渡されます。The parameters collection is passed to the BrowseTo, OpenForm, OpenQuery, OpenReport, or RunDataMacro method. メソッドが実行されると、parameters コレクションは必要なパラメーターを提供します。When the method is run, the parameters collection supplies the needed parameters. メソッドが終了すると、parameters コレクションはクリアされます。When the method is finished, the parameters collection is cleared.

パラメーターを受け取る各メソッドは、完了と共にパラメーター コレクションをクリアするので、パラメーターが必要なメソッドを呼び出す直前に SetParameter を呼び出す必要があります。Because each of the methods that accepts parameters clears the parameters collection when it completes, you must ensure that your calls to SetParameter immediately precede the call to the method that employs them.

Example

次のコード例では、addcomment データマクロで使用する2つのパラメーターを作成します。The following code example creates two parameters for use by the AddComment data macro. 2つのパラメーターには、それぞれ prmcomment と prmRelatedID という名前が付けられます。The two parameters are named prmComment and prmRelatedID, respectively. txtcommentテキストボックスの値は、prmcomment パラメーターに格納されます。The value of the txtComment text box is stored in the prmComment parameter. [ txtid ] テキストボックスの値は、prmRelatedID パラメーターに格納されます。The value of the txtId text box is stored in the prmRelatedID parameter.

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

サポートとフィードバックSupport and feedback

Office VBA またはこの説明書に関するご質問やフィードバックがありますか?Have questions or feedback about Office VBA or this documentation? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.