MACROMEDIA COLDFUSION MX 61-CFML Reference page 211

This attribute is
required, optional,
ignored, or invalid:
username
password
webservice
timeout
proxyServer
proxyPort
proxyUser
proxyPassword
input_params ...
If the attribute specifies a component name, the component with the corresponding
component
name is instantiated, the requested method is invoked, and then the component instance is
immediately destroyed. If the attribute contains a reference to an instantiated component object,
no instantiation or destruction of the component occurs.
On UNIX systems, ColdFusion searches first for a file with a name that matches the specified
component name, but is all lower case. If it does not find the file, it looks for a file name that
matches the component name exactly, with the identical character casing.
Method arguments can be passed in any of the following ways. If an argument is passed in more
than one way with the same name, this order of precedence applies:
Using the
1
cfinvokeargument
Passing directly as attributes of the
2
registered
cfinvoke
Passing as struct keys, using the
3
For example, the
params
as if the arguments were passed to the method in the order
<cfinvoke ... a=2 b=2 argumentCollection=params>
<cfinvokeargument name="a" value="3">
</cfinvoke>
Note: The following cfinvoke tag attribute names are reserved; they cannot be used for argument
names: component, method, argumentCollection, and result.
Example1
This example uses Syntax 1.
<!--- immediate instantiation and destruction --->
<cfinvoke
component="nasdaq.quote"
method="getLastTradePrice"
returnVariable="res">
<cfinvokeargument
name="symbol"
value="macr">
For this tag syntax:
cfinvoke
Syntax 1 Syntax 2
Ignored Ignored
Ignored Ignored
Ignored Ignored
Invalid Invalid
Invalid Invalid
Invalid Invalid
Invalid Invalid
Invalid Invalid
Optional Optional
tag
cfinvoke
attribute: ,
method component
argumentCollection
struct contains three keys:
Syntax 3 Syntax 4A
Optional Ignored
Optional Ignored
Required Ignored
Optional Invalid
Optional Invalid
Optional Invalid
Optional Invalid
Optional Invalid
Optional Optional
tag (they cannot have the same name as a
, ,
webservice returnVariable
attribute
, , . The following call is evaluated
a=1 b=1 c=1
, ,
a=3 b=2 c=1
Syntax 4B
Optional
Optional
Required
Optional
Optional
Optional
Optional
Optional
Optional
)
:
cfinvoke 211