PivotGridField.UnboundType Property

Gets or sets the data type and binding mode of the field. This is a dependency property.

Namespace: DevExpress.Xpf.PivotGrid

Assembly: DevExpress.Xpf.PivotGrid.v14.2.dll

Declaration

C#

[XtraSerializablePropertyId(2)]
[XtraSerializableProperty]
public FieldUnboundColumnType UnboundType { get; set; }

VB.NET

<XtraSerializablePropertyId(2)>
<XtraSerializableProperty>
Public Property UnboundType As FieldUnboundColumnType

Property Value

Type	Description
FieldUnboundColumnType	A FieldUnboundColumnType enumeration value representing the data type and binding mode of the field.

Remarks

The DXPivotGrid supports unbound fields. These fields are not bound to any field in the control's data source which is specified by the PivotGridControl.DataSource property.

You can provide data for unbound fields using one of two methods:

• via the PivotGridField.UnboundExpression property.

  This specifies a formula in a string form used to evaluate the field's values.

• by handling the PivotGridControl.CustomUnboundFieldData event.

  This approach allows you to implement complex algorithms for populating unbound fields.

To make a field unbound, set its UnboundType property to a FieldUnboundColumnType value that corresponds to the type of data that the field will display. For instance, if the field is supposed to display integer values, set the UnboundType property to FieldUnboundColumnType.Integer.

See the FieldUnboundColumnType topic for information on the available data types for unbound fields. The data type specified by the UnboundType property determines how field values are sorted.

If the field's UnboundType property is set to FieldUnboundColumnType.Bound, it's assumed that this field is not unbound and it is bound to a specific field in the data source, specified by the PivotGridField.FieldName property.

The PivotGridField.FieldName property's value of an unbound field must be unique, and not match any field name in the underlying data source.