Skip to main content
All docs
V24.2

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

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.v24.2.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