ASPxReportDesigner.StaticInitialize() Method

Explicitly starts the Report Designer initialization.

Namespace: DevExpress.XtraReports.Web

Assembly: DevExpress.XtraReports.v18.2.Web.WebForms.dll

Declaration

C#

public static void StaticInitialize()

VB.NET

Public Shared Sub StaticInitialize

Remarks

The ASPxReportDesigner is automatically initialized when rendering on your application’s Web page, but in specific cases, you need to trigger its initialization explicitly (for instance, when an AppPool is recycled).

The StaticInitialize method does the following:

• Calls the static ASPxReportDesigner constructor;
• Registers HttpHandlers required for the Report Designer, Web Document Viewer and Query Builder;
• Initializes all services for processing requests to the corresponding handlers.

Use the StaticInitialize method at the application startup in the Global.asax file.

Note

To make the Report Designer’s handlers work correctly, you should call this method after specifying the session state and registering additional services.

C#

protected void Application_Start(Object sender, EventArgs e) {
    // ...  
   DevExpress.XtraReports.Web.ReportDesigner.Native.ReportDesignerBootstrapper.SessionState = 
        System.Web.SessionState.SessionStateBehavior.Required;
    // ...  
    DevExpress.XtraReports.Web.ASPxReportDesigner.StaticInitialize();
}

VB.NET

Protected Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
    ' ...  
    DevExpress.XtraReports.Web.ReportDesigner.Native.ReportDesignerBootstrapper.SessionState = 
        System.Web.SessionState.SessionStateBehavior.Required
    ' ...  
    DevExpress.XtraReports.Web.ASPxReportDesigner.StaticInitialize
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the StaticInitialize() method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

Reporting_how-to-use-the-web-report-designer-and-web-document-viewer-in-the-web-gardens-t528588/CS/DevExpressWebFarmsWebGardenReporting/Global.asax.cs#L22

    DefaultWebDocumentViewerContainer.RegisterSingleton<CacheCleanerSettings>(cacheCleanerSettings);
    DevExpress.XtraReports.Web.ASPxReportDesigner.StaticInitialize();
}

Reporting_How-to-add-and-use-custom-types-for-report-parameters-in-the-web-reporting-controls/CS/CustomReportParameterType/Global.asax.cs#L25

MVCxReportDesigner.StaticInitialize();
AreaRegistration.RegisterAllAreas();

Reporting_How-to-customize-the-document-viewer-toolbar/CS/DXWebApplication1/Global.asax.cs#L15

    DevExpress.XtraReports.Web.Extensions.ReportStorageWebExtension.RegisterExtensionGlobal(new ReportStorageWebExtension1(Path.Combine(HttpRuntime.AppDomainAppPath, "Reports")));
    ASPxReportDesigner.StaticInitialize();
}

Reporting_How-to-customize-the-report-designer-toolbar/CS/DXWebApplication1/Global.asax.cs#L15

    DevExpress.XtraReports.Web.Extensions.ReportStorageWebExtension.RegisterExtensionGlobal(new ReportStorageWebExtension1(Path.Combine(HttpRuntime.AppDomainAppPath, "Reports")));
    ASPxReportDesigner.StaticInitialize();
}

how-to-create-a-custom-color-scheme-for-web-reporting-controls/CS/WebReportingCustomColorScheme/Global.asax.cs#L12

DevExpress.XtraReports.Web.ReportDesigner.Native.ReportDesignerBootstrapper.SessionState = System.Web.SessionState.SessionStateBehavior.Default;
ASPxReportDesigner.StaticInitialize();

VB.NET

Reporting_how-to-use-the-web-report-designer-and-web-document-viewer-in-the-web-gardens-t528588/VB/DevExpressWebFarmsWebGardenReporting/Global.asax.vb#L23

    DefaultWebDocumentViewerContainer.RegisterSingleton(Of CacheCleanerSettings)(cacheCleanerSettings)
    DevExpress.XtraReports.Web.ASPxReportDesigner.StaticInitialize()
End Sub

Reporting_How-to-add-and-use-custom-types-for-report-parameters-in-the-web-reporting-controls/VB/CustomReportParameterType/Global.asax.vb#L27

MVCxReportDesigner.StaticInitialize()
AreaRegistration.RegisterAllAreas()

Reporting_How-to-customize-the-document-viewer-toolbar/VB/DXWebApplication1/Global.asax.vb#L17

    DevExpress.XtraReports.Web.Extensions.ReportStorageWebExtension.RegisterExtensionGlobal(New ReportStorageWebExtension1(Path.Combine(HttpRuntime.AppDomainAppPath, "Reports")))
    ASPxReportDesigner.StaticInitialize()
End Sub

Reporting_How-to-customize-the-report-designer-toolbar/VB/DXWebApplication1/Global.asax.vb#L18

    DevExpress.XtraReports.Web.Extensions.ReportStorageWebExtension.RegisterExtensionGlobal(New ReportStorageWebExtension1(Path.Combine(HttpRuntime.AppDomainAppPath, "Reports")))
    ASPxReportDesigner.StaticInitialize()
End Sub

how-to-create-a-custom-color-scheme-for-web-reporting-controls/VB/WebReportingCustomColorScheme/Global.asax.vb#L14

DevExpress.XtraReports.Web.ReportDesigner.Native.ReportDesignerBootstrapper.SessionState = System.Web.SessionState.SessionStateBehavior.Default
ASPxReportDesigner.StaticInitialize()