BI Dashboard .NET Limitations

• Jul 10, 2023
• 2 minutes to read

This topic describes .NET platform limitations for the DevExpress BI Dashboard.

System.Drawing.Common Package

Version 6

With the release of .NET 6, the System.Drawing.Common library is compatible with Windows only. See the following Microsoft documentation topic for more information: System.Drawing.Common only supported on Windows.

Use one of the following options to fix this issue:

• Replace the System.Drawing.Common library with the earlier version 5.0.3.

  Version 5.0.3 retains compatibility with Linux, MacOS, and other platforms. An application built for these platforms does not throw the exception described above. Note that Microsoft does not issue fixes for non-Windows bugs and vulnerabilities.

• As a temporary workaround, enable the System.Drawing.EnableUnixSupport configuration property to prevent the exception on non-Windows platforms. You should add a runtimeconfig.template.json file to your project with the following code:

  runtimeconfig.template.json

  {
      "configProperties": {
          "System.Drawing.EnableUnixSupport": true
      }
  }
  

  This file is a template for the runtimeconfig.json files generated by your project. For more information, review the following help topic in the Microsoft documentation: .NET Runtime configuration settings.

Version 7 and Higher

The following features are not available in the BI Dashboard in .NET 7 and non-Windows environments:

• GaugeDashboardItem export.
• TreemapDashboardItem export.

You can call the DevExpress.Drawing.Internal.DXDrawingEngine.ForceSkia() method at application startup to force enable the new Skia-based drawing engine. Note that this API is marked as internal and we may change it in the future.

Tip

Are you currently using .NET Framework and ready to transition to .NET 6+ or move your solutions to the Cloud?

We recognize that migrating/rewriting legacy applications can be a significant undertaking. If you are ready to transition to newer versions of .NET or move your solution to the cloud, be sure to review the following highly rated help topics:

• .NET Upgrade Assistant Tool | Overview from Microsoft Build
• Start your cloud journey with Azure App Service
• ASP.NET to ASP.NET Core tutorial playlist on YouTube
• Reliable Web App pattern (RWA) on GitHub (a guidance for building around existing apps without the need for a complete rewrite)