Skip to main content
All docs
V24.2

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

DesignAnalyzerOptions Class

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

Namespace: DevExpress.XtraReports.Configuration

Assembly: DevExpress.XtraReports.v24.2.dll

NuGet Package: DevExpress.Reporting.Core

#Declaration

public class DesignAnalyzerOptions

The following members return DesignAnalyzerOptions objects:

#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