ColumnBase.UnboundType Property

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

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v19.2.Core.dll

Declaration

C#

[DefaultValue(UnboundColumnType.Bound)]
public UnboundColumnType UnboundType { get; set; }

VB.NET

<DefaultValue(UnboundColumnType.Bound)>
Public Property UnboundType As UnboundColumnType

Property Value

Type	Default	Description
UnboundColumnType	**Bound**	A UnboundColumnType enumeration value that represents the data type and binding mode of the column.

Available values:

Name	Description
Bound	Indicates that the column is bound to a field in the control’s underlying data source. The type of data this column contains is determined by the bound field.
Integer	Indicates that the column is unbound and it contains integer values (the Int32 type).
Decimal	Indicates that the column is unbound and it contains decimal values (the Decimal type).
DateTime	Indicates that the column is unbound and it contains date/time values (the DateTime type).
String	Indicates that the column is unbound and it contains string values (the String type).
Boolean	Indicates that the column is unbound and it contains Boolean values (the Boolean type).
Object	Indicates that the column is unbound and it contains values of any type. A TextEdit editor is assigned for the in-place editing of such a column.

Remarks

Unbound columns are not bound to any field in the data source. These columns must be populated manually by handling the GridControl.CustomUnboundColumnData event.

To make a column unbound, set its UnboundType property to a UnboundColumnType value that corresponds to the type of data the column will display. For example, if the column is supposed to display integer values, set the UnboundType property to UnboundColumnType.Integer. The data type specified by the UnboundType property, determines which editor should be used by default to edit the column’s values.

If the column’s UnboundType property is set to UnboundColumnType.Bound, it’s assumed that this column is bound to a data field in the data source, specified by the column’s ColumnBase.FieldName property.

To learn more, see Unbound Columns.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the UnboundType property.

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.

C#

how-to-embed-animation-into-grid-cells-e1532/CS/AnimateCells/Window1.xaml#L31

    <dxg:GridColumn FieldName="Distance" Header="Distance (m)" FixedWidth="True" Width="100" EditSettings="{dxe:TextSettings DisplayFormat=0.00}" />
    <dxg:GridColumn FieldName="AnimationElement" UnboundType="Object" Visible="False" />
</dxg:GridControl.Columns>

how-to-select-data-rows-e1666/CS/DXGrid_RowSelection/Window1.xaml#L39

    <dxg:GridColumn FieldName="UnitPrice" />
    <dxg:GridColumn FieldName="Selected" UnboundType="Boolean" />
</dxg:GridControl.Columns>

how-to-display-an-icon-in-an-unbound-column-based-on-the-value-stored-in-a-bound-column-e1266/CS/UnboundColumnWithIcons/Window1.xaml#L10

    <dxg:GridColumn FieldName="Action" />
    <dxg:GridColumn FieldName="IconUnbound" UnboundType="Object" CellTemplate="{StaticResource IconCellTemplate}" />
</dxg:GridControl.Columns>

how-to-add-a-check-box-into-a-column-header-to-select-deselect-all-rows-e3840/CS/WpfApplication2/MainWindow.xaml#L39

<dxg:GridColumn FieldName="Number" />
<dxg:GridColumn FieldName="Selected" UnboundType="Boolean" AllowSorting="False">
    <dxg:GridColumn.HeaderTemplate>

how-to-implement-an-unbound-editable-check-column-e1263/CS/UnboundCheckColumn/Window1.xaml#L14

<dxg:GridColumn FieldName="Number" />
<dxg:GridColumn FieldName="Selected" UnboundType="Boolean" AllowSorting="False">
    <dxg:GridColumn.CellTemplate>

VB.NET

how-to-change-background-color-for-modified-cells-e1297/VB/HighlightChangedCellBehavior.vb#L79

unboundColumn.FieldName = UnboundColumnPrefix & column.FieldName
unboundColumn.UnboundType = UnboundColumnType.Boolean
unboundColumn.Visible = False