ASP.NET Core Reporting

• Apr 03, 2020
• 3 minutes to read

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

Note

Review the Reporting for .NET Core 3 document if your application uses .NET Core 3.

Prerequisites

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

• Install .Net Core 2.1 SDK or later.

• Install Visual Studio 2017 v15.7 or later with the following workloads:

  • ASP.NET and web development
  • .NET Core cross-platform development

Add a Report to an ASP.NET Core Application

The Add a Report to Your VS Project tutorial provides instructions on how to add a report to a project and edit it in the Visual Studio Report Designer.

Add a Report Created in .NET Application to an ASP.NET Core Application

1. Save the source report to REPX file.
2. Create a new blank report in the .NET Core Application.
3. Open the Report Designer in the .NET Core Application and load the saved REPX file into a blank report.
4. Copy the code-behind content from the source report file in the ASP.NET application to the corresponding code-behind report file in the ASP.NET Core application.

Add the Report Designer and Document Viewer 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:

• Add an End-User Report Designer to an ASP.NET Core Application

• Add the Document Viewer to an ASP.NET Core Application

Add DevExpress Reporting Controls to a React Application with the ASP.NET Core Backend

Review the following example: How to Use the ASP.NET Core Back-End to Integrate the Document Viewer and Report Designer in JavaScript with React Library

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

The following tutorials describe how to use the DevExpress Template Gallery and .NET Core command line interface (CLI) to create an ASP.NET Core reporting application:

• Create an ASP.NET Core Application with a Report Designer
• Create an ASP.NET Core Angular Application with a Report Designer
• Create an ASP.NET Core Application with a Document Viewer
• Create an ASP.NET Core Angular Application with a Document Viewer

Customize Report Designer and Document Viewer in an ASP.NET Core Application

• Report Designer - API and Customization
• Document Viewer - API and Customization

Upgrade a Project

The following topic describes how to upgrade a project to a newer version of reporting controls:

• Upgrade to a New Package Version

Localize an Application

The Localization topic describes how to use JSON files from the DevExpress Localization Service to localize reporting controls in an ASP.NET Core application. Review the Globalization and localization in ASP.NET Core article for general information on ASP.NET Core platform.

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
 RUN apt-get install -y libicu-dev libharfbuzz0b libfontconfig1 libfreetype6
 ...

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.
• Deserialization from CodeDOM format is not supported in .NET Core applications.
• The Visual Studio Report Designer does not display a preview for reports whose data source is based on the Entity Framework.
• The ImageExportOptions.Resolution property does not work in Linux- and Mac-based environments.
• Mac-based environments can not embed fonts in exported PDF files.
• Report inheritance is not supported.