Skip to main content
All docs
V25.1
  • ReportWizardCustomizationService.CustomizeReportOnFinishAsync(XtraReport) Method

    Allows you to customize the report before loading it into the End-User Designer for further editing, asynchronously.

    Namespace: DevExpress.XtraReports.Web.ReportDesigner.Services

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

    NuGet Package: DevExpress.Web.Reporting.Common

    Declaration

    public virtual Task CustomizeReportOnFinishAsync(
        XtraReport report
    )

    Parameters

    Name Type Description
    report XtraReport

    A report created using wizard steps.

    Returns

    Type Description
    Task

    A Task that completes when the method is finished.

    Remarks

    The CustomizeReportOnFinishAsync method is called in asynchronous mode.

    The CustomizeReportOnFinishAsync method is called when a user has completed all the steps within the Report Wizard, and after the TryCreateCustomReportAsync method.

    The CustomizeReportOnFinishAsync method is also called when a user runs the New command in the Report Designer.

    The following code adds a report header to the report created using the wizard:

      public override Task CustomizeReportOnFinishAsync(XtraReport report) {
          if (report.Bands.GetBandByType(typeof(ReportHeaderBand)) == null)
              report.Bands.Add(new ReportHeaderBand() { Controls = { new XRLabel() { Text = "My Report" } } });
          return Task.CompletedTask;
      } 
    

    For more information on asynchronous mode, review the following help topics:

    ASP.NET Core ASP.NET MVC
    ReportingConfigurationBuilder.UseAsyncEngine DefaultReportDesignerContainer.UseAsyncEngine
    See Also