Microsoft Azure Specifics

• Aug 03, 2020
• 2 minutes to read

Important

This documentation applies to v16.2. Starting with v17.1, the ASPxDashboardViewer control is in maintenance mode. In v19.1, the new Web Dashboard Control replaces the old Web Dashboard Viewer. This means that the Web Dashboard Viewer will not be included in our installation packages. See our blog post for more information.

Refer to the following KB articles to learn how to migrate to ASPxDashboard / ASP.NET MVC Dashboard:

• ASPxDashboardViewer -> ASPxDashboard

  How to migrate from ASPxDashboardViewer to ASPxDashboard working in the ViewerOnly mode

• MVCxDashboardViewer -> MVCxDashboard

  How to migrate from DashboardViewerExtension to DashboardExtension working in the ViewerOnly mode

The Web Viewer has exporting specifics when a web application is deployed to Microsoft Azure. If the dashboard or specific dashboard items are exported to PDF or image formats, their content is saved to the Windows Metafile format, which is not supported by Azure. To overcome this limitation, set the DashboardExportSettings.CompatibilityMode property to DashboardExportCompatibilityMode.Restricted at the application startup.

C#

using DevExpress.DashboardCommon;
// ...

void Application_Start(object sender, EventArgs e) {
    DashboardExportSettings.CompatibilityMode = DashboardExportCompatibilityMode.Restricted;
}

VB.NET

Imports DevExpress.DashboardCommon
' ...

Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
    DashboardExportSettings.CompatibilityMode = DashboardExportCompatibilityMode.Restricted
End Sub

In this case, images from the corresponding exported documents will be always rendered as bitmaps.