PivotGridControl.CreateDrillDownDataSourceAsync(Int32, Int32, Int32, AsyncCompletedHandler) Method

Returns a list of records used to calculate a summary value for the specified cell asynchronously. Allows you to limit the number of records to be returned.

Namespace: DevExpress.XtraPivotGrid

Assembly: DevExpress.XtraPivotGrid.v20.1.dll


public void CreateDrillDownDataSourceAsync(
    int columnIndex,
    int rowIndex,
    int maxRowCount,
    AsyncCompletedHandler asyncCompleted
Public Sub CreateDrillDownDataSourceAsync(
    columnIndex As Integer,
    rowIndex As Integer,
    maxRowCount As Integer,
    asyncCompleted As AsyncCompletedHandler


Name Type Description
columnIndex Int32

A zero-based integer which identifies the visible index of the column. Pass -1 as a column index to obtain the column's Grand Total.

rowIndex Int32

A zero-based integer which identifies the visible index of the row. Pass -1 as a row index to obtain the row's Grand Total.

maxRowCount Int32

An integer value that specifies the maximum number of data rows to be returned. -1 to retrieve all rows.

asyncCompleted AsyncCompletedHandler

A AsyncCompletedHandler delegate referencing a method that should be executed after the operation is completed. The drill-down data source is passed to this method as a parameter.


The CreateDrillDownDataSourceAsync method is asynchronous. It starts executing the related operation in a background thread, and immediately returns control. The primary UI thread is not blocked, allowing the application to continue responding to end-user actions. For more information about the asynchronous mode, see Asynchronous Mode.

The drill-down data source (a PivotDrillDownDataSource instance) is passed to the asyncCompleted delegate via the result parameter. This parameter returns an AsyncOperationResult instance. Use the AsyncOperationResult.Value property to obtain the drill-down data source.

To create a drill-down data source synchronously, use the PivotGridControl.CreateDrillDownDataSource method.


In OLAP mode, calling this method is equivalent to calling the PivotGridControl.CreateOLAPDrillDownDataSourceAsync method with the customColumns parameter set to null.


Calling the CreateDrillDownDataSourceAsync method from the PivotGridControl.CustomSummary and PivotGridControl.CustomUnboundFieldData event handlers may result in the stack overflow exception. To provide custom cell values that require obtaining the underlying data to be calculated, handle the PivotGridControl.CustomCellValue event, and call the CreateDrillDownDataSourceAsync method in the event handler.


This example performs an asynchronous operation that creates a drill-down data source for the selected PivotGrid cell and gets the operation result - the underlying data source.

In this example, the PivotGrid control is bound to the LinqServerModeSource data source and operates in server mode.

The PivotGridControl.CellClick event handler calls the PivotGridControl.CreateDrillDownDataSourceAsync method to generate a drill-down data source for the selected cell. The method parameter specifies the number of records to return. The method also specifies the columns to add to the the data set.

The last item in the method's parameter list is the AsyncCompletedHandler delegate. The delegate is executed when the operation is complete. The delegate's result parameter is the AsyncOperationResult instance whose Value property contains the result of the operation.

The operation's result is cast to the PivotDrillDownDataSource and the GridControl displays the underlying records in the auxiliary DrillDown form.


The complete sample project How to Create the Underlying Data Source (Drill-Down) in an Asynchronous Operation is available in the DevExpress Examples repository.

using DevExpress.XtraPivotGrid;
using System;
using System.Collections.Generic;

namespace XtraPivotGrid_CreateDrillDownDataSourceAsync {
    public partial class Form1 : DevExpress.XtraEditors.XtraForm
        DrillDownForm dForm;
        public Form1()
            this.Load += Form1_Load;
            pivotGridControl1.CellClick += pivotGridControl1_CellClick;
            // This line of code is generated by Data Source Configuration Wizard
            linqServerModeSource1.QueryableSource = new XtraPivotGrid_CreateDrillDownDataSourceAsync.DataClasses1DataContext().Invoices;
        private void pivotGridControl1_CellClick(object sender, 
            DevExpress.XtraPivotGrid.PivotCellEventArgs e) {
            PivotGridControl pivot = sender as PivotGridControl;
            if (dForm.IsDisposed) LoadDrillDownForm();

            //Check whether an asynchronous operation is in progress.
            if (!pivot.IsAsyncInProgress)

                // Get the record set associated with the clicked cell.
                pivot.CreateDrillDownDataSourceAsync(e.ColumnIndex, e.RowIndex, 25, new List<string> { "ProductName","Quantity" }, result => {
                    // The 'result' parameter of the delegate returns an AsyncOperationResult instance.
                    // The AsyncOperationResult.Value property contains a record set.
                    dForm.DataSource = (PivotDrillDownDataSource)result.Value;
        private void Form1_Load(object sender, EventArgs e)
        private void LoadDrillDownForm()
            dForm = new DrillDownForm();
See Also