entityLoadByExample

Description

Loads and returns an array of objects that match the sampleentity.The filter criteria is constructed by ANDing all the non-null properties of the sampleentity.

History

ColdFusion 9: Added this function.

Syntax

entityloadbyexample(sampleentity [, unique])

Attributes

Attribute	Description	Required	Default
sampleentity	Name of the sample entity that is used to match and filter similar entities to load.

Returns

Array of objects

Example

<cfset employee= CreateObject("component", "employee")> 
<cfset employee.setDepartment("ColdFusion")> 
<cfset employee.setCountry("USA")> 
<cfset employee=EntityLoadByExample(employee)>

cfmldocs