ModificationsController.ModificationsHandlingMode Property

Specifies the WinForms application behavior when a user modifies data and then changes the current object or closes the View.

Namespace: DevExpress.ExpressApp.SystemModule

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

[DefaultValue(ModificationsHandlingMode.Confirmation)]
public ModificationsHandlingMode ModificationsHandlingMode { get; set; }

VB.NET

<DefaultValue(ModificationsHandlingMode.Confirmation)>
Public Property ModificationsHandlingMode As ModificationsHandlingMode

Property Value

Type	Default	Description
ModificationsHandlingMode	Confirmation	A ModificationsHandlingMode enumeration value that specifies the WinForms application behavior when a user modifies data and then changes the current object or closes the View.

Available values:

Name	Description
Confirmation	The “Do you want to save changes (yes/no)” confirmation is displayed.
AutoCommit	Data modifications are committed automatically without displaying any confirmation.
AutoRollback	Data modifications are discarded without displaying any confirmation.

Remarks

To specify the ModificationsHandlingMode in your code, inherit the WinModificationsController and override the OnActivated method.

C#

using DevExpress.ExpressApp.SystemModule;
using DevExpress.ExpressApp.Win.SystemModule;
// ...
public class MyWinModificationsController : WinModificationsController {
    protected override void OnActivated() {
        base.OnActivated();
        if (View is ListView)
            this.ModificationsHandlingMode = ModificationsHandlingMode.AutoCommit;
    }
}

VB.NET

Imports DevExpress.ExpressApp.SystemModule
Imports DevExpress.ExpressApp.Win.SystemModule
// ...
Public Class MyWinModificationsController
    Inherits WinModificationsController
    Protected Overrides Sub OnActivated()
        MyBase.OnActivated()
        If (TypeOf View Is ListView) Then
            Me.ModificationsHandlingMode = ModificationsHandlingMode.AutoCommit
        End If
    End Sub
End Class

Note that a custom value should be assigned after the base class’ OnActivated method is called, as the default value is calculated by this method. Avoid changing the ModificationsHandlingMode by accessing the ModificationsController from a custom controller via the Frame.GetController<ControllerType> method. Your custom controller may be activated before the ModificationsController activation, and your customization will be ignored.