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.

Returns

Array of objects

Category

ORM functions

Function Syntax

entityloadbyexample(sampleentity [, unique])

See Also

EntityLoad, EntityReload

History

ColdFusion 9: Added this function.

Parameters

Parameter

Description

sampleentity

Name of the sample entity that is used to match and filter similar entities to load.

Example

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