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 サービスを呼び出すときに、このパラメータを省略しません。