Skip to main content
All docs
V24.1

AzureWebDocumentViewerContainer.UseAzureEnvironment() Method

Enables the Web Document Viewer and Report Designer in the preview mode to use Azure Storage.

Namespace: DevExpress.XtraReports.Web.Azure.WebDocumentViewer

Assembly: DevExpress.XtraReports.v24.1.Web.Azure.dll

NuGet Package: DevExpress.Web.Reporting.Azure

Declaration

public static void UseAzureEnvironment()

Remarks

If you call the UseAzureEnvironment() method without arguments in your application, implement and register the following services:

This method is used in ASP.NET MVC and ASP.NET Web Forms applications. In ASP.NET Core applications, use the following method:

The Web Document Viewer is stateful and employs two levels of server-side caching to prevent redundant report creation.

Reports are cached in memory for a specified duration, even after closing the browser, but scaling with multiple servers can lead to issues if a server without the cached data handles a new request.

The UseAzureCachedReportSourceBuilder method is an alternative to these types of document cache storages. This method uses Azure services to implement document caching.

The UseAzureCachedReportSourceBuilder method creates the following tables in the storage account:

  • dxxrcommonstorage
  • dxxrdocumentmetadata
  • dxxrdocumentstructure
  • dxxrexporteddocuments
  • dxxrreports
  • dxxrvsearch

You can allocate separate storage for reporting the cache and configure expiration times for cached records in the Azure portal.

The goals of the UseAzureCachedReportSourceBuilder method and the UseAzureEnvironment method are the same. However, the UseAzureEnvironment method allows you to process events for a generated document object, while the UseAzureCachedReportSourceBuilder method works with serialized objects.

For more information, review the following help topics:

See Also