The method is designed for saving changes made in an entity instance.
procedure Save(Entity: TMappedEntity; Cascade: boolean = False);
The method performs permanent saving of modifications made in an entity instance. If the entity was deleted with TCustomEntityContext.Delete, then when executing this method, there occurs deletion of references to this entity in linked entities, deletion of the entity from linked entities collections, as well as deletion of data from corresponding database structures.
For irreversible saving of changes of all entities attached to the data context, the TDataContext.SubmitChanges method is used.