IObjectSpace.CustomDeleteObjects Event

The IObjectSpace.Delete method raises the CustomDeleteObjects event. Handle this event to replace the default persistent object deletion logic with custom logic.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

event EventHandler<CustomDeleteObjectsEventArgs> CustomDeleteObjects

VB.NET

Event CustomDeleteObjects As EventHandler(Of CustomDeleteObjectsEventArgs)

Event Data

The CustomDeleteObjects event's data class is DevExpress.ExpressApp.CustomDeleteObjectsEventArgs.

Remarks

Use the handler’s CustomDeleteObjectsEventArgs.Objects parameter to get the objects to be deleted. Set the handler’s CompletedEventArgs.Handled parameter to true to indicate that the delete operation has already been performed.

The Controller below specifies the IsMarkedAsDeleted property of CustomDeleteObjectsEventArgs.Objects instead of removing them:

File: MySolution.Module\Controllers\CustomDeleteObjectController.cs(.vb).

C#

using DevExpress.ExpressApp;
// ...
public class CustomDeleteObjectController : ObjectViewController<DetailView, Employee> {
    protected override void OnActivated() {
        base.OnActivated();
        ObjectSpace.CustomDeleteObjects += ObjectSpace_CustomDeleteObjects;
    }
    private void ObjectSpace_CustomDeleteObjects(object sender, CustomDeleteObjectsEventArgs e) {
        foreach (object deletingObject in e.Objects) {
            Employee employee = ObjectSpace.GetObject(deletingObject) as Employee;
            // IsMarkedAsDeleted is a custom Employee's property
            employee.IsMarkedAsDeleted = true;
        }
        e.Handled = true;
    }
    protected override void OnDeactivated() {
        ObjectSpace.CustomDeleteObjects -= ObjectSpace_CustomDeleteObjects;
        base.OnDeactivated();
    }
}

VB.NET

Imports DevExpress.ExpressApp
' ...
Public Class CustomDeleteObjectController
    Inherits ObjectViewController(Of DetailView, Employee)
    Protected Overrides Sub OnActivated()
        MyBase.OnActivated()
        AddHandler ObjectSpace.CustomDeleteObjects, AddressOf ObjectSpace_CustomDeleteObjects
    End Sub
    Private Sub ObjectSpace_CustomDeleteObjects(ByVal sender As Object, ByVal e As CustomDeleteObjectsEventArgs)
        For Each deletingObject As Object In e.Objects
            Dim employee As Employee = TryCast(ObjectSpace.GetObject(deletingObject), Employee)
            ' IsMarkedAsDeleted is a custom Employee's property
            employee.IsMarkedAsDeleted = True
        Next deletingObject
        e.Handled = True
    End Sub
    Protected Overrides Sub OnDeactivated()
        RemoveHandler ObjectSpace.CustomDeleteObjects, AddressOf ObjectSpace_CustomDeleteObjects
        MyBase.OnDeactivated()
    End Sub
End Class

Note

• This event is raised only when you use IObjectSpace‘s methods to delete objects.
• XPO has similar functionality out-of-the-box: Deferred and Immediate Object Deletion.

If you implement the IObjectSpace interface in the BaseObjectSpace class descendant, you can override the BaseObjectSpace.DeleteCore method instead of handling the CustomDeleteObjects event. The BaseObjectSpace.Delete method calls the BaseObjectSpace.DeleteCore method and raises the CustomDeleteObjects event. This allows you to implement custom persistent object deletion logic in any of these places. For more information, refer to the IObjectSpace.Delete method description.