The constructor is designed for creating a new entity instance.
constructor Create(const KeyValue: Variant); overload;
The method creates a new entity instance. The entity key attribute will be initialized by the specified value. The entity instance created by this method is not attached to the data context (is not placed to the object cache), therefore it won't be automatically destroyed on application shutdown. It should be destroyed manually. It is expedient to use the method in case when the primary key value of an entity is unknown at the moment of its creation (or there is no confidence in its uniqueness), in order to avoid an exception on an attempt to place an object to the cache.
To attach an entity instance to the data context and place it to the object cache, the TCustomEntityContext.Attach method should be used.
The method is the analogue of the TCustomEntityContext.CreateEntity method.