Whatever message this page gives is out now! Go check it out!

EntityLoadByExample

Last update:
May 18, 2026

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

Function Syntax

EntityLoadByExample(sampleEntity,[unique=false,matchCriteria=""])

See Also

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

Share this page

Was this page helpful?
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Thank you for your feedback. Your response will help improve this page.

On this page