WinApplication.HandleException(Exception) Method

Shows the message box with details on the specified exception.

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 void HandleException(
    Exception e
)

VB.NET

Public Sub HandleException(
    e As Exception
)

Parameters

Name	Type	Description
e	Exception	A System.Exception object representing an exception that occurred.

Remarks

Triggers the WinApplication.CustomHandleException event. If the event’s Handled parameter is not set to true, the message box is displayed via the Messaging.Show method (an overload that takes the caption and exception parameters is used).

The HandleException method is called each time an exception occurs when running a Windows Forms application (see the snippet from the Program.Main method below).

C#

static void Main() {
    // ...
   try {
        winApplication.Setup();
        winApplication.Start();
    }
    catch (Exception e) {
        winApplication.HandleException(e);
    }
}

VB.NET

Shared Sub Main()
    ' ...
   Try
        winApplication.Setup()
        winApplication.Start()
    Catch e As Exception
        winApplication.HandleException(e)
    End Try
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the HandleException(Exception) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

xaf-how-to-create-and-setup-an-xtrareport-report-for-exporting-to-a-stream-in-a-non-xaf/CS/ExportReportDemoEF/ExportReportDemoEF.Win/Program.cs#L39

catch(Exception e) {
    winApplication.HandleException(e);
}

XAF_how-to-add-custom-buttons-actions-to-the-lookup-and-popup-windows/CS/WinSolution.Win/Program.cs#L31

} catch (Exception e) {
    _application.HandleException(e);
}

xaf-how-to-execute-actions-in-code/CS/WinWebSolution.Win/Program.cs#L31

} catch (Exception e) {
    winApplication.HandleException(e);
}

xaf-how-to-show-audit-entries-for-a-current-object-and-its-aggregated-objects-in-one-list/CS/E4565.Win/Program.cs#L39

catch(Exception e) {
    winApplication.HandleException(e);
}

xaf-how-to-use-tree-list-editors-to-display-list-views/CS/HowToUseTreeListEditor.Win/Program.cs#L34

catch(Exception e) {
    winApplication.HandleException(e);
}

VB.NET

xaf-how-to-create-and-setup-an-xtrareport-report-for-exporting-to-a-stream-in-a-non-xaf/VB/ExportReportDemoEF/ExportReportDemoEF.Win/Program.vb#L42

Catch e As Exception
    winApplication.HandleException(e)
End Try

XAF_how-to-add-custom-buttons-actions-to-the-lookup-and-popup-windows/VB/WinSolution.Win/Program.vb#L30

Catch e As Exception
    _application.HandleException(e)
End Try

xaf-how-to-execute-actions-in-code/VB/WinWebSolution.Win/Program.vb#L30

Catch e As Exception
    winApplication.HandleException(e)
End Try

xaf-how-to-show-audit-entries-for-a-current-object-and-its-aggregated-objects-in-one-list/VB/E4565_VB.Win/Program.vb#L39

Catch e As Exception
    _application.HandleException(e)
End Try

xaf-how-to-use-tree-list-editors-to-display-list-views/VB/HowToUseTreeListEditor.Win/Program.vb#L32

Catch e As Exception
    winApplication.HandleException(e)
End Try