EntityDAC

TCustomEntityContext.GetEntities Method

The method is designed for retrieving an entity collection by specified criteria.

Class

TCustomEntityContext

Syntax

function GetEntities(EntityClass: TMappedEntityClass; const Condition: string): IEntityEnumerable; overload;

Parameters
EntityClass
The class type of entities to be retrieved.
Condition
The string expression that defines the condition which each of selected entities must conform.

Remarks

The method returns a collection of entities of the specified meta-type selected by the specified string condition. Collection members created by this method are initially attached to the data context and placed to the object cache, therefore you can already perform modification operations for them: TCustomEntityContext.Delete, TCustomEntityContext.Save, TCustomEntityContext.Cancel without pre-calling TCustomEntityContext.Attach. In addition, these entity instances will be automatically destroyed, and there will be no need to provide for their manual destruction.

Example

Examples of calling the method:

var
  EmpType: IMetaType;
  EmpEntities: IEntityEnumerable;
begin
  EmpType := Context['Emp'];
  EmpEntities := Context.GetEntities(EmpType, 'Sal > 1000');
  // ...
end; 

See Also

© 1997-2024 Devart. All Rights Reserved. Request Support DAC Forum Provide Feedback