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

NavigateToReportAction Class

Contains settings that allows you to implement a drill-through report.

Namespace: DevExpress.XtraReports.Interactivity

Assembly: DevExpress.XtraReports.v24.2.dll

NuGet Package: DevExpress.Reporting.Core

#Declaration

public class NavigateToReportAction :
    XRAction,
    IXtraSupportDeserializeCollectionItem,
    IXtraSupportCreateContentPropertyValue

#Remarks

A drill-through report allows you to click on a report element and navigate to a detail report within the same print preview window.

To create drill-through reports, use the Action property of report controls (XRControl descendants). The property provides access to NavigateToReportAction. NavigateToReportAction allows you to specify the detail report instance or URL to define a master-detail relationship and obtain a collection of detail report parameter bindings.

The following code snippet shows how to define master-detail relationships between Category and Product reports within a single project:

using DevExpress.XtraReports.Interactivity;
using DevExpress.XtraReports.UI;

namespace Drill_through_example {
    public partial class XtraReportCategories : DevExpress.XtraReports.UI.XtraReport {
        public XtraReportCategories(){
            InitializeComponent();

            // Create a NavigateToReportAction instance and specify its settings
            NavigateToReportAction cellAction = new NavigateToReportAction();
            cellAction.ReportSource = new XtraReportProducts();

            // Assign the NavigateToReportAction object to the control’s Action property
            tableCell6.Action = cellAction;

        }
    }
}

When you switch to the preview, you can now click on the Category value in the table and navigate to the detail report that contains Product values.

Drill-through Category report

A Breadcrumb control automatically appears below the Document Viewer toolbar and allows you to navigate back to the original report.

Detail Product report

Review the following tutorial for more information on how to implement drill-through functionality in the UI: Create Drill-Through Reports.

#Inheritance

Object
XRAction
NavigateToReportAction
See Also