ReportDesignerExceptionHandler Class

Enables you to handle server-side errors in the Web Report Designer.

Namespace : DevExpress.XtraReports.Web.ReportDesigner.Services

Assembly : DevExpress.XtraReports.v25.2.Web.dll

NuGet Package : DevExpress.Web.Reporting.Common

Declaration

C#
VB.NET

csharp

public class ReportDesignerExceptionHandler :
    ExceptionHandler,
    IReportDesignerExceptionHandler,
    IExceptionHandler

Public Class ReportDesignerExceptionHandler
    Inherits ExceptionHandler
    Implements IReportDesignerExceptionHandler,
               IExceptionHandler

Remarks

The ReportDesignerExceptionHandler class provides the following methods:

GetUnknownExceptionMessage to handle exceptions of non-standard types, for which the Report Designer shows the standard ‘Internal Server Error’ message;
GetFaultExceptionMessage to handle FaultException;
GetExceptionMessage to handle all possible errors independent of their types.

The code snippet below demonstrates how to create a descendant from this class and override the GetUnknownExceptionMessage method to return an actual exception message.

C#
VB.NET

csharp

using System;
using DevExpress.XtraReports.Web.ReportDesigner.Services;

public class CustomReportDesignerExceptionHandler : ReportDesignerExceptionHandler {
    public override string GetUnknownExceptionMessage(Exception ex) {
        return ex.Message;
    }
}

Imports System
Imports DevExpress.XtraReports.Web.ReportDesigner.Services

Public Class CustomReportDesignerExceptionHandler
    Inherits ReportDesignerExceptionHandler

    Public Overrides Function GetUnknownExceptionMessage(ByVal ex As Exception) As String
        Return ex.Message
    End Function
End Class

To register the implemented exception handler, use the static DefaultReportDesignerContainer.Register method at the application’s startup as shown below:

C#
VB.NET

csharp

void Application_Start(object sender, EventArgs e) {
    // ...
    DevExpress.XtraReports.Web.ReportDesigner.DefaultReportDesignerContainer.
        Register<IReportDesignerExceptionHandler, CustomReportDesignerExceptionHandler>();
}

Private Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
    ' ...
    DevExpress.XtraReports.Web.ReportDesigner.DefaultReportDesignerContainer.
        Register(Of IReportDesignerExceptionHandler, CustomReportDesignerExceptionHandler)()
End Sub

See the following topics for more information:

Implements

IReportDesignerExceptionHandler

IExceptionHandler

Inheritance

Object ExceptionHandler ReportDesignerExceptionHandler