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: このタグが追加されました。

属性

属性 必須/
オプション 		デフォルト 説明

name

必須

 

引数名です。

value

必須

 

引数の値です。

omit

オプション

"no"

Web サービスを呼び出すときに、パラメータを省略できるようにします。cfinvoke の webservice 属性を指定していない場合に omit="yes" を指定すると、エラーになります。

"yes": Web サービスを呼び出すときに、このパラメータを省略します。

"no": Web サービスを呼び出すときに、このパラメータを省略しません。

使用方法

cfinvoke タグ本文の中に複数の cfinvokeargument タグを記述することができます。

cfinvokeargument タグを使用すると、渡す引数をダイナミックに決定できます。たとえば、条件式に基づいた引数名の決定や、cfif タグを利用した cfinvokeargument タグを実行するかどうかの決定ができます。

Web サービスを呼び出す場合、omit 属性を "yes" に設定すると、パラメータを省略できます。引数が nillable であることが WSDL で指定された場合、ColdFusion MX は関連する引数を null に設定します。minoccurs=0 であることが WSDL で指定された場合、ColdFusion MX は WSDL からの引数を省略します。

例1

<cfinvoke
   component="nasdaq.quote"
   method="getLastTradePrice"
   returnVariable="res">
   <cfinvokeargument 
      name="symbol" value="mot">
   <cfinvokeargument 
      name="symbol"    value="macr">
</cfinvoke>

<cfoutput>#res#</cfoutput>

例2

<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>

ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX* | ColdFusion 5* | フォーラム* | デベロッパーセンター | サポート情報 | バグ報告

バージョン7