Microsoft Azure Integration for DevExpress ASP.NET Web Forms and MVC Reports

This package allows ASP.NET Web Forms and ASP.NET MVC applications to cache documents generated with DevExpress Web Reporting in Azure Storage. The Web Document Viewer saves document files in Blob Storage and stores service information in Table Storage. As a result, the Web Document Viewer and Report Designer preview remain available across requests, application restarts, and load-balanced instances. This architecture enables scalable, stateless deployment in Azure-hosted environments such as Azure App Service and containers.

Key Features

• Caches generated report documents in Azure Blob Storage and stores Web Document Viewer service data in Azure Table Storage.
• Keeps document state available across requests, application restarts, and load-balanced instances to support stateless, horizontally scaled Azure deployments.
• Allows you to configure the Azure cache at application startup (AzureWebDocumentViewerContainer.UseCachedReportSourceBuilder).
• Supports Azure Service Bus for multi-instance synchronization through the UseAzureEnvironment method.
• Allows you to adjust the cached report, document, exported document, and search result lifetimes through the StorageCleanerSettings service.

Example: Cache Report Documents in Azure Storage

Install the Azure.Storage.Blobs and Azure.Data.Tables packages (add Azure.Messaging.ServiceBus v17.17.4+ for Service Bus scenarios). Configure the Web Document Viewer to use Azure Storage in the Global.asax Application_Start method, and provision required Azure resources:

using DevExpress.XtraReports.Web;
using DevExpress.XtraReports.Web.Azure;
using DevExpress.XtraReports.Web.Azure.WebDocumentViewer;

protected void Application_Start(object sender, EventArgs e) {
    // Cache generated documents in Azure Storage (pass your Azure Storage connection string).
    AzureWebDocumentViewerContainer.UseCachedReportSourceBuilder(cloudStorageConnectionString);
    ASPxWebDocumentViewer.StaticInitialize();
    // Create the dxxrreports/dxxrdocuments tables and the dxxrcommonstorage blob container (call once).
    ((IAzureResourceProvisionService)DefaultWebDocumentViewerContainer.Current
        .GetService(typeof(IAzureResourceProvisionService)))
        .CreateRequiredResourcesAsync().GetAwaiter().GetResult();
}

To keep storage credentials out of configuration files, call UseCachedReportSourceBuilder() without arguments and register your own IBlobServiceClientProvider and ITableServiceClientProvider implementations — for example, clients that authenticate with managed identity.

For the complete walkthrough, refer to the following help topic: Microsoft Azure Integration Specifics.

Evaluation Period, Pricing Options, and Licensing Terms

Whether you own a license or want to start a 30-day evaluation, download and register your DevExpress license key. To obtain your key, sign in to the DevExpress Download Manager with an existing DevExpress.com account or create a free account. For key registration instructions, see License Key for DevExpress Products.

If you purchase a license after evaluating a product, re-register your updated DevExpress license key to remove evaluation warnings and messages.

This package is included in the following commercial subscriptions:

• DevExpress Reporting Subscription
• DevExpress ASP.NET Subscription
• DevExpress DXperience Subscription
• DevExpress Universal Subscription

See DevExpress Subscriptions & Licensing for subscription comparison tables, purchasing FAQ, and licensing information.

Related Components/Packages

DevExpress.Web.Reporting — Web Document Viewer and End-User Report Designer for ASP.NET Web Forms and ASP.NET MVC. This package is required — install it alongside DevExpress.Web.Reporting.Azure.

dotnet add package DevExpress.Web.Reporting

Documentation

• Microsoft Azure Integration Specifics
• Cloud Integration Overview

Software Bill of Materials (SBOM)

To access SBOM files for DevExpress packages, please refer to the following article: Software Bill of Materials (SBOM) for DevExpress .NET assemblies/NuGet packages, JavaScript, VCL and other redistributable artifacts.

See Also: Information Security | Security - What You Need to Know

Useful Online Resources

• www.devexpress.com
• DevExpress Support Center
• DevExpress Blogs