CFINVOKEARGUMENT |
説明 パラメータの名前と値をコンポーネントメソッドまたは Web サービスに渡します。このタグは、cfinvoke タグ内で使用します。
カテゴリ 拡張タグ
シンタックス
    <cfinvokeargument
       name="argument name"
       value="argument value"
       omit = "yes"、"no">
関連項目 cfargument、cfcomponent、cffunction、cfinvoke、cfobject、cfproperty、cfreturn
ヒストリ ColdFusion MX 7: omit 属性が追加されました。 ColdFusion MX: このタグが追加されました。
使用方法 cfinvoke タグ本文の中に複数の cfinvokeargument タグを記述することができます。 cfinvokeargument タグを使用すると、渡す引数をダイナミックに決定できます。たとえば、条件式に基づいた引数名の決定や、cfif タグを利用した cfinvokeargument タグを実行するかどうかの決定ができます。 Web サービスを呼び出す場合、omit 属性を "yes" に設定すると、パラメータを省略できます。引数が nillable であることが WSDL で指定された場合、ColdFusion MX は関連する引数を null に設定します。minoccurs=0 であることが WSDL で指定された場合、ColdFusion MX は WSDL からの引数を省略します。
例
    <cfinvoke
       component="nasdaq.quote"
       method="getLastTradePrice"
       returnVariable="res">
       <cfinvokeargument
          name="symbol" value="mot">
       <cfinvokeargument
          name="symbol"    value="macr">
    </cfinvoke>

    <cfoutput>#res#</cfoutput>
例
    <cfinvoke
       webservice ="http://www.xmethods.net/sd/2001/BabelFishService.wsdl"
       method ="BabelFish"
       returnVariable = "varName"
       >
       <cfinvokeargument
          name="translationmode" value="en_es">
       <cfinvokeargument
          name="sourcedata" value="Hello world, friend">
    </cfinvoke>
    <cfoutput>#varName#</cfoutput>

NAME |
| 必須
引数名です。

VALUE |
| 必須
引数の値です。

OMIT |
| オプション
Default value: ""no"" Web サービスを呼び出すときに、パラメータを省略できるようにします。cfinvoke の webservice 属性を指定していない場合に omit="yes" を指定すると、エラーになります。 "yes": Web サービスを呼び出すときに、このパラメータを省略します。 "no": Web サービスを呼び出すときに、このパラメータを省略しません。