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.Xpf.PivotGrid
Assembly: DevExpress.Xpf.PivotGrid.v14.2.dll
Declaration
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
)
Parameters
Name | Type | Description |
---|---|---|
columnIndex | Int32 | A zero-based integer which identifies the visible index of the column. |
rowIndex | Int32 | A zero-based integer which identifies the visible index of the row. |
maxRowCount | Int32 | An integer value that specifies the maximum number of data rows to be returned. -1 to retrieve all rows. |
asyncCompleted | AsyncCompletedHandler | An 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. |
Remarks
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.
NOTE
In OLAP mode, calling this method is equivalent to calling the PivotGridControl.CreateOlapDrillDownDataSourceAsync method with the customColumns parameter set to null.
NOTE
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.