ASP.NET Core Reporting Best Practices

• Nov 17, 2023
• 2 minutes to read

The AspNetCore.Reporting.BestPractices repository contains an example application that demonstrates best practices when you design a web reporting application. The repository’s README file consists of the following sections that describe these best practices:

• How to Run the Example Application
  • Configure NuGet
  • Install NPM Dependencies
  • Start the Application
• Switch to Asynchronous Mode
• Optimize Memory Consumption
• Manage Database Connections
• Resolve the Entity Framework Core Context from the DI Container
• Application Security
  • Prevent Cross-Site Request Forgery
  • Token-based Authentication (ASP.NET Core)
  • Token-based Authentication (Angular)
  • Implement User Authorization
• Handle Exceptions
  • Log Errors that Occurred in the Code of DevExpress Reporting Components
  • Use Custom Exception Handlers
• Prepare Skeleton Screen
• Localize Client UI

How to Upgrade a Project

Each major DevExpress version has its own branch in the repository. If you download a branch with the same major version as you’ve got on your machine, no upgrade is necessary because packages are updated automatically when the project is built.

To upgrade a project manually, do the following:

1. Update NuGet packages for the solution.
2. Update the version of the @devexpress/analytics-core, devexpress-reporting-angular, devexpress-reporting, devexpress-richedit, and devextreme-dist packages in the package.json file and run npm install. The package.json files are in the ASP.NET Core MVC project’s root folder and in the ClientApp folder of the AspNetCore.Reporting.Angular project.

For more information, review the Version Upgrade Guide for Web Reporting help topic.