CompositeObjectSpace.AutoRefreshAdditionalObjectSpacesByDefault Field

Specifies whether Object Spaces refresh their inner Object Spaces from the AdditionalObjectSpaces collection when refreshing themselves. This field affects all Object Spaces in your application if you do not specify the AutoRefreshAdditionalObjectSpaces property for a particular Object Space.

Namespace : DevExpress.ExpressApp

Assembly : DevExpress.ExpressApp.v25.2.dll

NuGet Package : DevExpress.ExpressApp

csharp

public static bool AutoRefreshAdditionalObjectSpacesByDefault

Public Shared AutoRefreshAdditionalObjectSpacesByDefault As Boolean

Field Value

Type	Description
Boolean

true , if Object Spaces refresh their inner Object Spaces from the AdditionalObjectSpaces collection when refreshing themselves; otherwise, false.

Remarks

If a non-persistent object contains a reference to or a collection of persistent objects, you need to refresh their Object Spaces 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.

The following example shows how to specify this static field for a WinForms application.

csharp

using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Win;
// ...
public partial class MySolutionWindowsFormsApplication : WinApplication {
    // ...
    public MySolutionWindowsFormsApplication() {
        NonPersistentObjectSpace.AutoRefreshAdditionalObjectSpacesByDefault = true;
        // ...
    }
}