IStorageDbInitializer Interface

Enables you to initialize database tables for the XPO-based cache storages.

Namespace: DevExpress.XtraReports.Web.WebDocumentViewer

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

NuGet Package: DevExpress.Web.Reporting.Common

Declaration

C#

public interface IStorageDbInitializer

VB.NET

Public Interface IStorageDbInitializer

Remarks

The IStorageDbInitializer interface initializes the database specified in the connection string that is passed to the following methods used for database caching:

ASP.NET Core	ASP.NET Web Forms & MVC
UseDbStorage(String)	UseDbStorage(String)

The IStorageDbInitializer interface is intended for situations when an application runs under a user account without administrator rights. For security reasons, you can deny access to system tables and prohibit modifications to the database schema of the database account used in the end-user application. In such cases, you can use the IStorageDbInitializer interface to update the database schema under administrator credentials:

ASP.NET MVC (Global.asax.cs)

((IStorageDbInitializer)DevExpress.XtraReports.Web.WebDocumentViewer.DefaultWebDocumentViewerContainer.Current.GetService(typeof(IStorageDbInitializer))).InitDbSchema();
// ...
DevExpress.XtraReports.Web.ASPxWebDocumentViewer.StaticInitialize();

ASP.NET Core (Program.cs)

public class Program {
   public static void Main(string[] args) {
       IWebHost host = CreateWebHostBuilder(args).Build();

       if (args.Any(s => s == "--update-database") {
           using (var scope = host.Services.CreateScope()) {
               var services = scope.ServiceProvider;

               services.GetRequiredService<IStorageDbInitializer>().InitDbSchema();
           }
       }
       host.Run();
   }

   public static IWebHostBuilder CreateWebHostBuilder(string[] args) {
       return WebHost.CreateDefaultBuilder(args)
           .UseStartup<Startup>();
   }
}

The IStorageDbInitializer.InitDbSchema() method operates with the database specified in the connection string passed to the UseDbStorage method in the startup configuration. The InitDbSchema() method creates tables needed to implement the cache and store reports, documents and exported documents.

For more information, review the following help topic: Web Document Viewer Cache Management.