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 Packages: DevExpress.ExpressApp.Win, DevExpress.ExpressApp.Win.Design

NuGet Package: DevExpress.ExpressApp.Win

Declaration

C#

public event EventHandler<CustomHandleExceptionEventArgs> CustomHandleException

VB.NET

Public Event CustomHandleException As EventHandler(Of CustomHandleExceptionEventArgs)

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.

C#

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.
    }
}

VB.NET

Friend NotInheritable Class Program
    Private Sub New()
    End Sub
    Shared Sub Main()
        ' ...
        Dim winApplication As MySolutionWindowsFormsApplication = _
        New CustomMessagingWindowsFormsApplication()
        '...
        AddHandler winApplication.CustomHandleException, _
        AddressOf winApplication_CustomHandleException
        ' ...
        Try
            winApplication.Setup()
            winApplication.Start()
        Catch e As Exception
            winApplication.HandleException(e)
        End Try
    End Sub
    ' ...
    Private Shared Sub winApplication_CustomHandleException( _
    ByVal sender As Object, ByVal e As CustomHandleExceptionEventArgs)
        ' Place your code here. Set e.Handled to true to prohibit displaying default message box.
    End Sub
End Class