CFOBJECT: COMPONENT OBJECT | |
Description
Creates an instance of a ColdFusion component (CFC) object. | |
Syntax<cfobject name = "variable name" component = "component name"> |
|
See also
cfcollection, cfcomponent, cfexecute, cfindex, cfreport, cfsearch, cfwddx; "Using ColdFusion components" in Chapter 10, "Building and Using ColdFusion Components," in ColdFusion MX Developer's Guide
|
|
Usage
When the cfobject tag creates an instance of the CFC, ColdFusion executes any constructor code in the CFC; that is, it runs code that is not in the method definitions. On UNIX systems, ColdFusion searches first for a file with a name that matches the specified component name, but is all lowercase. If it does not find the file, it looks for a filename that matches the component name exactly, with the identical character casing. |
|
Example<!--- Separate instantiation and method invocation; permits multiple invocations. ---> <cfobject name="quoteService" component="nasdaq.quote"> <cfinvoke component="#quoteService#" method="getLastTradePrice" symbol="macr" returnVariable="res"> <cfoutput>#res#</cfoutput><br> <cfinvoke component="#quoteService#" method="getLastTradePrice" symbol="mot" returnVariable="res"> <cfoutput>#res#</cfoutput> |
NAME | |
Required | |
String; name for the instantiated component. The name must not have a period as the first or last character. |
COMPONENT | |
Required | |
Name of component to instantiate. |