User Guide Cancel

EntityNew

 

NOTE

This function has been enhanced in ColdFusion 9.0.1 to support multiple data sources in the same application.

Description

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

Returns

Object

Category

ORM functions

Function Syntax

EntityNew(entityName,[properties="",ignoreExtras=false])

Parameters

Parameter

Description

entityName

Entity name of the persistent CFC.

properties

Key-value pair (ColdFusion struct) of property names and values.

See Also

EntityLoadEntityLoadByExampleEntityDeleteColdFusion ORM chapter in Developing ColdFusion Applications

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,

<cfset artistObj = entityNew("Artists",{FirstName="Tom",LastName="Ron"})>

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();

 

 

Get help faster and easier

New user?