EntityNew

NOTE

This function has been enhanced in ColdFusion 9.0.1 to support multiple data sources in the same application. Install the ColdFusion 9 update to use the feature.

Description

Creates an instance of the persistent CFC with the entity name that you provide.

Returns

Object

Function Syntax

entityNew(entityName [ ,properties])

Parameters

Parameter	Description
entityName	Entity name of the persistent CFC.
properties	Key-value pair (ColdFusion struct) of property names and values.

History

ColdFusion 9: Added this function.

Usage

The enhancement in ColdFusion 9.0.1 allows the application to initialize the object that is being created. properties takes a struct with key being the property name. When the object is created, all the properties are populated with the passed struct.For example,

Example

newArtistObj = EntityNew("Artists");
newArtistObj.setfirstname("John");
newArtistObj.setlastname("Smith");
newArtistObj.setaddress("5 Newport lane");
newArtistObj.setcity("San Francisco");
newArtistObj.setstate("CA");
newArtistObj.setPostalCode("90012");
newArtistObj.setphone("612-832-2343");
newArtistObj.setfax("612-832-2344");
newArtistObj.setemail("jsmith@company.com");
newArtistObj.setThePassword("jsmith");
EntitySave(newartistobj);
ormflush();