Skip to main content

Grid Columns

  • 2 minutes to read

A column consists of the following elements:

  • A column header identifies a column. This header displays the column’s caption and allows users to move and resize the column, and sort and filter data. To change a column’s caption, specify the ColumnBase.Header property.
  • Cells display values from the corresponding field in a data source.

WinUI Grid - Column

Create Columns

The GridControl creates columns for all fields in a data source if the DataControlBase.AutoGenerateColumns property is set to true.

Follow the steps below to manually add columns to the GridControl:

  1. Set the DataControlBase.AutoGenerateColumns property to false.
  2. Add ColumnBase descendants to the DataControlBase.Columns collection.
  3. Specify the ColumnBase.FieldName property for each column to bind it to the data source field.

WinUI Grid Get Started | Manual Columns

<dxg:GridControl ItemsSource="{x:Bind ViewModel.Source}" AutoGenerateColumns="False">
    <dxg:GridControl.Columns>
        <dxg:GridTextColumn FieldName="ProductName"/>
        <dxg:GridTextColumn FieldName="Country"/>
        <dxg:GridSpinEditColumn FieldName="UnitPrice"/>
        <dxg:GridTextColumn FieldName="Quantity"/>
        <dxg:GridDateColumn FieldName="OrderDate"/>
    </dxg:GridControl.Columns>
</dxg:GridControl>

Column Types

The GridControl includes columns for multiple data types. The following table lists available column types:

Column Type Description
GridTextColumn Displays text values.
GridSpinEditColumn Displays numeric values.
GridCheckBoxColumn Displays Boolean values.
GridComboBoxColumn Displays lists.
GridDateColumn Displays date-time values.
GridMaskColumn Allows you to use the GridMaskColumn.Mask property to restrict data input and format data output.
GridTemplateColumn Allows you to use the GridTemplateColumn.CellTemplate property to specify custom appearance for displayed data.
See Also