User Guide

530 Chapter 3: ColdFusion Functions

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)

See also

Chapter 10, “Building and Using ColdFusion Components” in ColdFusion MX Developer’s Guide

Parameters

Usage

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

Server's Local Time:

tellTimeCFC=CreateObject("component","appResources.components.

tellTime");

tellTimeCFC.getLocalTime();

</cfscript>

Calculated UTC Time:

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