Skip to main content
.NET 6.0+

WinApplication.CustomHandleException Event

Occurs before displaying a message box with an exception message.

Namespace: DevExpress.ExpressApp.Win

Assembly: DevExpress.ExpressApp.Win.v24.1.dll

NuGet Package: DevExpress.ExpressApp.Win

Declaration

public event EventHandler<CustomHandleExceptionEventArgs> CustomHandleException

Event Data

The CustomHandleException event's data class is CustomHandleExceptionEventArgs. The following properties provide information specific to this event:

Property Description
Exception Gets the exception that occurred.
Handled Gets or sets a value that indicates whether the event handler has completely handled the event or whether the system should continue its own processing. Inherited from HandledEventArgs.
OriginalException Gets the original exception.

Remarks

Raised as the result of executing the WinApplication.HandleException method. Handle the CustomHandleException event to customize the exceptions processing in a Windows Forms application. Place a custom code in this event handler, and it will be executed before the message box is shown. The exception that occurs is accessible via the Exception parameter. You can set the handler’s Handled parameter, to prohibit displaying the default message box.

static class Program {
    static void Main() {
        // ...
        MySolutionWindowsFormsApplication winApplication = 
            new MySolutionWindowsFormsApplication();
        //...
        winApplication.CustomHandleException += winApplication_CustomHandleException;
        // ...
        try {
            winApplication.Setup();
            winApplication.Start();
        }
        catch (Exception e) {
            winApplication.HandleException(e);
        }
    }
    // ...
    static void winApplication_CustomHandleException(
        object sender, CustomHandleExceptionEventArgs e) {
        // Place your code here. Set e.Handled to true to prohibit displaying default message box.
    }
}
See Also