The method is designed for retrieving an existing entity instance by specified criteria.
function GetEntity(MetaExpr: IMetaType; const KeyValues: array of Variant): TMappedEntity; overload;
The method returns an entity instance of the specified meta-type selected by the specified complex primary key values. The entity instance created by this method is initially attached to the data context and placed to the object cache (in contrast to the TCustomEntityContext.CreateEntity method), therefore you can already perform modification operations for the instance: TCustomEntityContext.Delete, TCustomEntityContext.Cancel) without pre-calling TCustomEntityContext.Attach. In addition, this entity instance will be automatically destroyed, and there will be no need to provide for its manual destruction.
var EmpType: IMetaType; EmpEntity: TEmp; begin EmpType := Context['Emp']; EmpEntity := Context.GetEntity(EmpType, [1, 1]) as TEmp; // ... end;