User Guide

CreateObject 425
CreateObject: component object
Description
The CreateObject function can create an instance of a ColdFusion component (CFC) object.
Returns
A component object.
Function syntax
CreateObject(type, component-name)
Parameters
Usage
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.
In the following example, the CFScript statements assign the
tellTimeCFC variable to the
tellTime component using the CreateObject function. The CreateObject function references
the component in another directory. To invoke component methods, you use function syntax.
For more information, see Chapter 11, “Building and Using ColdFusion Components,” in
Developing ColdFusion MX Applications.
Example
<b>Server's Local Time:</b>
<cfscript>
tellTimeCFC=CreateObject("component","appResources.components.
tellTime");
tellTimeCFC.getLocalTime();
</cfscript>
<br>
<b>Calculated UTC Time:</b>
<cfscript>
tellTimeCFC.getUTCTime();
</cfscript>
Parameter Description
type Type of object to create.
• com
• corba
• java
• component
• webservice
component-name The CFC name; corresponds to the name of the file that defines the
component; for example, use engineComp to specify the component defined
in the engineComp.cfc file