ASP.NET Core Reporting
- 3 minutes to read
Topics in this section describe how to create reporting applications in ASP.NET Core.
Review the Reporting for .NET Core 3 document if your application uses .NET Core 3.
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
- Save the source report to REPX file.
- Create a new blank report in the .NET Core Application.
- Open the Report Designer in the .NET Core Application and load the saved REPX file into a blank report.
- 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 the Document Viewer to an ASP.NET Core Application
- Add an End-User Report Designer to an ASP.NET Core Application
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 Angular Application with a Report Designer From Template
- Create an ASP.NET Core Application with a Document Viewer
- Create an Angular Application with a Document Viewer From Template
Customize Report Designer and Document Viewer in an ASP.NET Core Application
Upgrade a Project
The following topic describes how to upgrade a project to a newer version of reporting controls:
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.
Draw Reports on Linux and MacOS
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 ...
- 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.