Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

ExceptionHandler.GetFaultExceptionMessage(FaultException) Method

Enables you to handle FaultException that occurs on the server side.

Namespace: DevExpress.XtraReports.Web.ClientControls

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

NuGet Package: DevExpress.Web.Reporting.Common

#Declaration

public virtual string GetFaultExceptionMessage(
    FaultException ex
)

#Parameters

Name Type Description
ex FaultException

An exception that occurs on the server side.

#Returns

Type Description
String

A string to show in a browser when an error occurs.

#Remarks

The GetFaultExceptionMessage method is called whenever FaultException occurs (for instance, when you pass an invalid URL to a report storage).

The following classes are inherited from the base ExceptionHandler class and provide this method:

The code snippet below demonstrates how to create a descendant from the ReportDesignerExceptionHandler class and override the GetExceptionMessage method to return a custom message.

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

public class CustomReportDesignerExceptionHandler : ReportDesignerExceptionHandler {
    public override string GetFaultExceptionMessage(FaultException ex) {
        return "FaultException occured.";
    }
}

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

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

See the following topics for more information:

See Also