PivotGridControl.CustomUnboundFieldData Event

Enables providing data to unbound fields.

Namespace: DevExpress.Xpf.PivotGrid

Assembly: DevExpress.Xpf.PivotGrid.v24.1.dll

NuGet Package: DevExpress.Wpf.PivotGrid

Declaration

C#

public event PivotCustomFieldDataEventHandler CustomUnboundFieldData

VB.NET

Public Event CustomUnboundFieldData As PivotCustomFieldDataEventHandler

Event Data

The CustomUnboundFieldData event's data class is PivotCustomFieldDataEventArgs. The following properties provide information specific to this event:

Property	Description
Field	Gets the unbound field currently being processed.
ListSourceRowIndex	Gets the current row’s index in the data source.
ThreadSafeField	Gets the unbound field currently being processed. Provides read-only access to field settings.
Value	Gets or sets the value of the cell currently being processed.

The event data class exposes the following methods:

Method	Description
GetListSourceColumnValue(Int32, String)	Gets the value of the specified field in the specified row in the control’s underlying data source.
GetListSourceColumnValue(String)	Gets the value of the specified cell within the current row in the control’s underlying data source.

Remarks

Important

This member is not supported in Optimized, OLAP, and Server modes. Use ExpressionDataBinding for Optimized mode instead.

Unbound fields are not bound to any field in the data source. In most instances, data for unbound fields is obtained from a custom data source or is calculated based upon the values of bound fields. To provide data for unbound fields, you can specify an expression (formula) used to evaluate values for this field using the PivotGridField.UnboundExpression property or handle the CustomUnboundFieldData event.

To learn more about unbound data, see Unbound Fields.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the CustomUnboundFieldData event.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAML

wpf-pivotgrid-hide-column-totals/CS/HowToBindToMDB/MainWindow.xaml#L8

<Grid>
    <dxpg:PivotGridControl CustomUnboundFieldData="pivotGridControl1_CustomUnboundFieldData"
                           CustomCellValue="PivotGridControl1_CustomCellValue"