NonPersistentObjectSpace Class

An Object Space used to manage non-persistent objects.

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#
VB.NET

public class NonPersistentObjectSpace :
    CompositeObjectSpace

Public Class NonPersistentObjectSpace
    Inherits CompositeObjectSpace

Remarks

To enable the use of NonPersistentObjectSpace, the following code should be added to the overridden CreateDefaultObjectSpaceProvider method located in the WinApplication.cs (WinApplication.vb) and/or WebApplication.cs (WebApplication.vb) file (in addition to the existing XPObjectSpaceProvider or EFObjectSpaceProvider).

C#
VB.NET

protected override void CreateDefaultObjectSpaceProvider(CreateCustomObjectSpaceProviderEventArgs args) {
    // ...
    args.ObjectSpaceProviders.Add(new NonPersistentObjectSpaceProvider(TypesInfo, null));
}

Protected Overrides Sub CreateDefaultObjectSpaceProvider(ByVal args As CreateCustomObjectSpaceProviderEventArgs)
    ' ...
    args.ObjectSpaceProviders.Add(New NonPersistentObjectSpaceProvider(TypesInfo, Nothing))
End Sub

Currently, this code is added automatically by the Solution Wizard, but it may be missing if you have created your project using an older version of XAF.

Note

XAF uses the first registered Object Space Provider for the following purposes:

To get XafApplication.ObjectSpaceProvider and XafApplication.ConnectionString property values.
To pass this Provider as the CustomCheckCompatibilityEventArgs ObjectSpaceProvider argument.
To update an application.

Ensure that NonPersistentObjectSpaceProvider is not the first registered Provider in your application.

Note that in applications with the Application Builder, you need to use the Application Builder’s ObjectSpaceProviders property to register Object Space Providers instead of the XafApplication.CreateDefaultObjectSpaceProvider method or XafApplication.CreateCustomObjectSpaceProvider event to register Object Space Providers. Refer to the following help topic for more information on how to do this: Integrate Application Builders into Existing Applications.

We strongly recommend this because the use of the XafApplication.CreateDefaultObjectSpaceProvider method and XafApplication.CreateCustomObjectSpaceProvider event conflicts with IObjectSpaceFactory and IObjectSpaceProviderFactory service usage.

This technique also improves performance of your application because the application instance is not created in this case.

To supply non-persistent objects for NonPersistentObjectSpace, use the NonPersistentObjectSpace.ObjectsGetting event that occurs when NonPersistentObjectSpace creates an object collection. You can find examples in the following topics:

To supply an object returned by the NonPersistentObjectSpace.GetObject method, use the NonPersistentObjectSpace.ObjectGetting event.

The New, Delete and Save Actions are available for non-persistent objects. To access all created, deleted and modified objects within NonPersistentObjectSpace, use the NonPersistentObjectSpace.ModifiedObjects property.

The IObjectSpaceLink.ObjectSpace property of non-persistent objects that support IObjectSpaceLink is initialized in these cases:

An object is created using the IObjectSpace.CreateObject method.
An object is accessed using the NonPersistentObjectSpace.GetObject method.
A collection is accessed using the IObjectSpace.GetObjects or IObjectSpace.CreateCollection method.

If an object from another Object Space passed to the GetObject method implements IObjectSpaceLink, and its ObjectSpace property is null, the current NonPersistentObjectSpace assigns a link to itself in this property. Similar behavior is implemented for objects returned by the GetObjects and CreateCollection methods using the NonPersistentObjectSpace.ObjectsGetting event.