IDrillThroughProcessor Interface

Implements drill-through functionality in web reports.

Namespace: DevExpress.XtraReports.Web.WebDocumentViewer

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

NuGet Package: DevExpress.Web.Reporting.Common

Declaration

C#

public interface IDrillThroughProcessor

VB.NET

Public Interface IDrillThroughProcessor

Remarks

To add drill-through functionality to reports in an application, create a class that implements the IDrillThroughProcessor interface. Its CreateReport method accepts the DrillThroughContext object and returns a report for display. Call the ServiceCollectionServiceExtensions.AddScoped<TService,TImplementation> method to register a custom drill-through processor at application startup.

CustomDrillThroughProcessor.cs

using System;
using System.Text.Json;
using DevExpress.XtraReports.Services;
using DevExpress.XtraReports.Web.WebDocumentViewer;
// ...
    public class NavigateInfo {
        public string NavigateTo { get; set; }
        public string MasterID { get; set; }
    }
    public class CustomDrillThroughProcessor : IDrillThroughProcessor {
        readonly IReportProvider reportProvider;

        public CustomDrillThroughProcessor(IReportProvider reportProvider) {
            this.reportProvider = reportProvider;
        }
        public DrillThroughResult CreateReport(DrillThroughContext context) {
            NavigateInfo navigateInfo = JsonSerializer.Deserialize<NavigateInfo>(context.CustomData);
            var reportNameToOpen = navigateInfo.NavigateTo == "back" ? "MainReport"
                : navigateInfo.NavigateTo == "details" ? "DetailReport1" : null;
            var report = reportProvider.GetReport(reportNameToOpen, null) ?? context.Report;

            if(navigateInfo.NavigateTo == "details") {
                int catID = 0;
                Int32.TryParse(navigateInfo.MasterID, out catID);
                report.Parameters["categoryID"].Value = catID;
            }
            return new DrillThroughResult(report);
        }
    }

Startup.cs

using Microsoft.Extensions.DependencyInjection;
using DevExpress.XtraReports.Web.WebDocumentViewer;
// ...
    public class Startup {
        // ...
        public void ConfigureServices(IServiceCollection services) {
            services.AddDevExpressControls();
            // ...
            services.AddScoped<IDrillThroughProcessor, CustomDrillThroughProcessor>();
        }
    }