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

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