PreviewReportCustomizationService.CreateCachedReportSource(XtraReport) Method

Enables you to assign a CachedReportSourceWeb object to the current report when the Report Designer is about to be switched to the Preview tab.

Namespace: DevExpress.XtraReports.Web.ReportDesigner.Services

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

Declaration

C#

public virtual CachedReportSourceWeb CreateCachedReportSource(
    XtraReport report
)

VB.NET

Public Overridable Function CreateCachedReportSource(
    report As XtraReport
) As CachedReportSourceWeb

Parameters

Name	Type	Description
report	XtraReport	The current report to be previewed.

Returns

Type	Description
CachedReportSourceWeb	A CachedReportSourceWeb object.

Remarks

The CreateCachedReportSource method is called after the CustomizeReport method and allows you to assign a CachedReportSourceWeb object to the customized report.

The following example demonstrates how to change the report’s orientation and assign a new CachedReportSourceWeb instance.

C#

using DevExpress.XtraReports.UI;
using DevExpress.XtraReports.Web;
using DevExpress.XtraReports.Web.ReportDesigner.Services;

public class MyPreviewReportCustomizationService: PreviewReportCustomizationService {
    public override void CustomizeReport(XtraReport report) {
        report.Landscape = true;
    }

    public override CachedReportSourceWeb CreateCachedReportSource(XtraReport report) {
        return new CachedReportSourceWeb(report);
    }
}

VB.NET

Imports DevExpress.XtraReports.UI
Imports DevExpress.XtraReports.Web
Imports DevExpress.XtraReports.Web.ReportDesigner.Services

Public Class MyPreviewReportCustomizationService
    Inherits PreviewReportCustomizationService

    Public Overrides Sub CustomizeReport(ByVal report As XtraReport)
        report.Landscape = True
    End Sub

    Public Overrides Function CreateCachedReportSource(ByVal report As XtraReport) As CachedReportSourceWeb
        Return New CachedReportSourceWeb(report)
    End Function
End Class

Then, register your custom service implementation at the application’s startup.

• ASP.NET WebForms and ASP.NET MVC

  C#

  using DevExpress.XtraReports.Web.ReportDesigner;
  using DevExpress.XtraReports.Web.ReportDesigner.Services;
  
  void Application_Start(object sender, EventArgs e) {
      DefaultReportDesignerContainer.Register<PreviewReportCustomizationService, MyPreviewReportCustomizationService>();
  }
  

  VB.NET

  Imports DevExpress.XtraReports.Web.ReportDesigner
  Imports DevExpress.XtraReports.Web.ReportDesigner.Services
  
  Private Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
      DefaultReportDesignerContainer.Register(Of PreviewReportCustomizationService, MyPreviewReportCustomizationService)()
  End Sub
  

• ASP.NET Core

  C#

  using DevExpress.XtraReports.Web.ReportDesigner.Services;
  
  public void ConfigureServices(IServiceCollection services) {
      // ...
      services.AddSingleton<PreviewReportCustomizationService, MyPreviewReportCustomizationService>();
  }