Back to Devexpress

CompositeObjectSpace.AutoRefreshAdditionalObjectSpaces Property

expressappframework-devexpress-dot-expressapp-dot-compositeobjectspace-02123cfc.md

latest4.8 KB
Original Source

CompositeObjectSpace.AutoRefreshAdditionalObjectSpaces Property

Specifies whether the current Object Space refreshes its inner Object Spaces from the AdditionalObjectSpaces collection when it refreshes itself.

Namespace : DevExpress.ExpressApp

Assembly : DevExpress.ExpressApp.v25.2.dll

NuGet Package : DevExpress.ExpressApp

Declaration

csharp
public bool AutoRefreshAdditionalObjectSpaces { get; set; }
vb
Public Property AutoRefreshAdditionalObjectSpaces As Boolean

Property Value

TypeDescription
Boolean

true , if the current Object Space refreshes its inner Object Spaces from the AdditionalObjectSpaces collection when it refreshes itself; otherwise, false. The default value equals the AutoRefreshAdditionalObjectSpacesByDefault static field’s value.

|

Remarks

If a non-persistent object contains a reference to or a collection of persistent objects, you need to refresh their Object Space after refreshing the parent non-persistent Object Space. Set this property to true to do this automatically each time the non-persistent Object Space refreshes.

After refreshing, drop all references and collections of outdated persistent objects and create new instances in refreshed persistent Object Spaces. Also, you can drop the non-persistent object with persistent objects it references and create a new instance again in the ObjectsGetting, ObjectGetting, and ObjectByKeyGetting event handlers.

Refer to the following GitHub example to see how to use this property: How to refresh Non-Persistent Objects and reload nested Persistent Objects.

The following code snippets (auto-collected from DevExpress Examples) contain references to the AutoRefreshAdditionalObjectSpaces property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAF_Non-Persistent-Objects-Reloading-Demo/CS/EFCore/NonPersReloadEF/NonPersReloadEF.Module/Module.cs#L45

csharp
npos.AutoDisposeAdditionalObjectSpaces = true;
npos.AutoRefreshAdditionalObjectSpaces = true;
new LiveSummaryAdapter(npos);

XAF_Non-Persistent-Objects-Edit-Linked-Persistent-Objects-Demo/CS/EFCore/NonPersistentEditEF/NonPersistentEditEF.Module/Module.cs#L45

csharp
npos.AutoDisposeAdditionalObjectSpaces = true;
npos.AutoRefreshAdditionalObjectSpaces = true;
npos.AutoCommitAdditionalObjectSpaces = true;

XAF_Non-Persistent-Objects-Nested-In-Persistent-Objects-Demo/CS/XPO/NonPersistentDemo/NonPersistentDemo.Module/Module.cs#L46

csharp
cos.AutoCommitAdditionalObjectSpaces = true;
    cos.AutoRefreshAdditionalObjectSpaces = true;
}

See Also

CompositeObjectSpace Class

CompositeObjectSpace Members

DevExpress.ExpressApp Namespace