Skip to main content
All docs
V24.1

DesignAnalyzerOptions Class

Contains methods that allow you to configure the Report Design Analyzer.

Namespace: DevExpress.XtraReports.Configuration

Assembly: DevExpress.XtraReports.v24.1.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

public class DesignAnalyzerOptions

Remarks

The Report Design Analyzer shows errors, warnings, and information messages that help you and your end users to detect and fix issues in a report.

The Report Design Analyzer (WinForms)

Use the DesignAnalyzerOptions class to configure the Report Design Analyzer. For example, you can enable or disable the following items:

You can use the DesignAnalyzerOptions class for all supported Desktop (WinForms and WPF) and Web platforms. To change the default settings, access the class instance in a method called at application startup and specify instance properties:

using DevExpress.XtraReports.Configuration;
//...

Settings.Default.DesignAnalyzerOptions.ShowErrors = false;

In reporting applications with an ASP.NET Core backend, change the default settings as follows:

var app = builder.Build();

app.UseReporting(x => {
    x.DesignAnalyzerOptions.ShowErrors = false;
});

app.Run();

Based on their source, report errors are divided into four groups:

  • Report layout errors – occur, for example, when report controls overlap each other or extend beyond the report’s printable area.
  • Report creation errors – occur while the report document is created. For instance, it might include notifications about invalid property values or unreachable sources of content.
  • Report export errors – happen while the report document is exported to PDF, XLSX, and other formats.
  • Report script errors – for example, errors in script syntax.

The Report Design Analyzer's default error set

You can use the following properties to disable error messages that belong to a particular error source:

Enable/Disable Messages of a Particular Error Type

Use the following properties to disable messages of the “Error”, “Warning”, or “Information” type:

You can also suppress error codes to disable messages associated with them. Refer to the SuppressedErrorCodes property description for instructions.

An error code link navigates users to a DevExpress Reporting documentation page that describes the error and how to fix it.

EnableErrorCodeLinks = true

Use the EnableErrorCodeLinks property to enable error code links.

Enable/Disable Error Notification Popup in Preview

A report document may contain errors that occur during its creation. The Report Design Analyzer shows them in a notification popup when you preview the report:

Notification popup

You can enable/disable this popup. See the description of the following property for details: ShowNotificationPopup.

Inheritance

Object
DesignAnalyzerOptions
See Also