[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
 [Expand]Product Information
 [Expand]Get Started with DevExpress Reporting
 [Expand]Create Popular Reports
 [Expand]Detailed Guide to DevExpress Reporting
 [Expand]Visual Studio Report Designer
 [Collapse]Create End-User Reporting Applications
   Cross-Platform Reporting
  [Expand]WinForms Reporting
  [Expand]WPF Reporting
  [Collapse]Web Reporting
   [Expand]General Information
   [Expand]ASP.NET WebForms Reporting
   [Expand]ASP.NET MVC Reporting
   [Collapse]ASP.NET Core Reporting
    [Expand]Document Viewer
    [Expand]End-User Report Designer
   [Expand]JavaScript Reporting
   [Expand]Application Security
    End-User Documentation
  [Expand]WCF Report Service
  [Expand]Discontinued Platforms
   Redistribution and Deployment
 [Expand]API Reference
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

ASP.NET Core Reporting

Topics in this section describe how to create reporting applications in ASP.NET Core.

Expanded Prerequisites

DevExpress Reporting has the following prerequisites in ASP.NET Core applications:

Expanded Add a Report to an ASP.NET Core Application

The Add a New Report to an ASP.NET Core Application tutorial provides instructions on how to add a report to an ASP.NET Core application and edit it in the Visual Studio Report Designer.

Expanded Add DevExpress Reporting Controls to an ASP.NET Core Application

The following tutorials describe how to add the Report Designer and Document Viewer to an ASP.NET Core application:

Expanded Create an ASP.NET Core Reporting Application Using a Project Template

Expanded Customize the Reporting Controls in an ASP.NET Core Application

Expanded Docker Support

Refer to the Visual Studio Tools for Docker with ASP.NET Core tutorial for instructions on how to dockerize (add to a Docker container) your DevExpress Reporting ASP.NET Core application.

Make the following changes to the docker file configuration when you add the application to a Linux container:

 FROM microsoft/aspnetcore:2.1 AS base
 RUN apt-get update
 RUN apt-get install -y libgdiplus libc6-dev

Expanded Limitations

  • The ObjectDataSource component cannot obtain the data source schema from referenced assemblies (only directly from the solution's projects).
  • Linux-based environments cannot generate 3D Charts that use the OpenGL library.
  • Report Scripts are not supported.
  • Deserialization from CodeDOM format is not supported in .NET Core applications.
  • The Visual Studio Report Designer does not display a preview for the reports whose data source is based on the Entity Framework.
  • The ImageExportOptions.Resolution property does not work in Linux- and Mac-based environments.
  • Linux- and Mac-based environments can not embed fonts in exported PDF files.

Expanded Move Reports from .NET Applications to .NET Core Applications

You can add the reports you designed in an ASP.NET application to an ASP.NET Core application.

Do the following to save an ASP.NET application's reports:

  1. Open your ASP.NET application in Visual Studio and invoke the Report Designer for a report.

  2. Click the report's smart tag and select Save....

    This allows you to save the report's definition in XML format as a REPX file. Refer to the Save Report Layouts topic for details.

Use one of the following techniques to add the saved report to an ASP.NET Core application:

  • Add the saved report definition to your ASP.NET Core application

    1. Open your ASP.NET Core application in Visual Studio and use the Add | Existing Item... command to add the saved REPX file.

    2. Double-click the added REPX file. While the Report Designer invokes, the report's Code Behind files are added to the project.


      The report's REPX file is added as an embedded resource. Reports with another value of the Build Action property cannot be loaded at runtime.

  • Load the saved report definition into an existing report (for example, create an empty report) in your ASP.NET Core application

    1. Open your ASP.NET Core application in Visual Studio and invoke the Report Designer for the existing report.

    2. Click the report's smart tag and select Open/Import....

      The Load Report Layouts topic details this operation.


Copy the report's Code Behind from the CS file in the ASP.NET application to the corresponding CS file in the ASP.NET Core application manually.

Now you can customize the added report in the same manner as you do it in an ASP.NET application.

Is this topic helpful?​​​​​​​