User Guide

cfobject: component object 315
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
Attributes
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>
Attribute Req/Opt Default Description
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.