DataGridViewColumn Class
Represents a column in a DataGridView control.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
System.Windows.Forms.DataGridViewElement
System.Windows.Forms.DataGridViewBand
System.Windows.Forms.DataGridViewColumn
System.Windows.Forms.DataGridViewButtonColumn
System.Windows.Forms.DataGridViewCheckBoxColumn
System.Windows.Forms.DataGridViewComboBoxColumn
System.Windows.Forms.DataGridViewImageColumn
System.Windows.Forms.DataGridViewLinkColumn
System.Windows.Forms.DataGridViewTextBoxColumn
| Name | Description | |
|---|---|---|
![]() | DataGridViewColumn() | Initializes a new instance of the DataGridViewColumn class to the default state. |
![]() | DataGridViewColumn(DataGridViewCell) | Initializes a new instance of the DataGridViewColumn class using an existing DataGridViewCell as a template. |
| Name | Description | |
|---|---|---|
![]() | AutoSizeMode | Gets or sets the mode by which the column automatically adjusts its width. |
![]() | CellTemplate | Gets or sets the template used to create new cells. |
![]() | CellType | Gets the run-time type of the cell template. |
![]() | ContextMenuStrip | Gets or sets the shortcut menu for the column.(Overrides DataGridViewBand.ContextMenuStrip.) |
![]() | DataGridView | Gets the DataGridView control associated with this element.(Inherited from DataGridViewElement.) |
![]() | DataPropertyName | Gets or sets the name of the data source property or database column to which the DataGridViewColumn is bound. |
![]() | DefaultCellStyle | Gets or sets the column's default cell style.(Overrides DataGridViewBand.DefaultCellStyle.) |
![]() | DefaultHeaderCellType | Gets or sets the run-time type of the default header cell.(Inherited from DataGridViewBand.) |
![]() | Displayed | Gets a value indicating whether the band is currently displayed onscreen. (Inherited from DataGridViewBand.) |
![]() | DisplayIndex | Gets or sets the display order of the column relative to the currently displayed columns. |
![]() | DividerWidth | Gets or sets the width, in pixels, of the column divider. |
![]() | FillWeight | Gets or sets a value that represents the width of the column when it is in fill mode relative to the widths of other fill-mode columns in the control. |
![]() | Frozen | Gets or sets a value indicating whether a column will move when a user scrolls the DataGridView control horizontally.(Overrides DataGridViewBand.Frozen.) |
![]() | HasDefaultCellStyle | Gets a value indicating whether the DefaultCellStyle property has been set. (Inherited from DataGridViewBand.) |
![]() | HeaderCell | Gets or sets the DataGridViewColumnHeaderCell that represents the column header. |
![]() | HeaderCellCore | Gets or sets the header cell of the DataGridViewBand.(Inherited from DataGridViewBand.) |
![]() | HeaderText | Gets or sets the caption text on the column's header cell. |
![]() | Index | Gets the relative position of the band within the DataGridView control.(Inherited from DataGridViewBand.) |
![]() | InheritedAutoSizeMode | Gets the sizing mode in effect for the column. |
![]() | InheritedStyle | Gets the cell style currently applied to the column.(Overrides DataGridViewBand.InheritedStyle.) |
![]() | IsDataBound | Gets a value indicating whether the column is bound to a data source. |
![]() | IsRow | Gets a value indicating whether the band represents a row.(Inherited from DataGridViewBand.) |
![]() | MinimumWidth | Gets or sets the minimum width, in pixels, of the column. |
![]() | Name | Gets or sets the name of the column. |
![]() | ReadOnly | Gets or sets a value indicating whether the user can edit the column's cells.(Overrides DataGridViewBand.ReadOnly.) |
![]() | Resizable | Gets or sets a value indicating whether the column is resizable.(Overrides DataGridViewBand.Resizable.) |
![]() | Selected | Gets or sets a value indicating whether the band is in a selected user interface (UI) state.(Inherited from DataGridViewBand.) |
![]() | Site | This API supports the product infrastructure and is not intended to be used directly from your code. Gets or sets the site of the column. |
![]() | SortMode | Gets or sets the sort mode for the column. |
![]() | State | Gets the user interface (UI) state of the element.(Inherited from DataGridViewElement.) |
![]() | Tag | Gets or sets the object that contains data to associate with the band.(Inherited from DataGridViewBand.) |
![]() | ToolTipText | Gets or sets the text used for ToolTips. |
![]() | ValueType | Gets or sets the data type of the values in the column's cells. |
![]() | Visible | Gets or sets a value indicating whether the column is visible.(Overrides DataGridViewBand.Visible.) |
![]() | Width | Gets or sets the current width of the column. |
The DataGridViewColumn class represents a logical column in a DataGridView control. You can retrieve columns through the Columns collection of the control.
Unlike a DataGridViewRow, which contains the actual collection of cells in a DataGridView, DataGridViewColumn is used mainly to adjust the appearance and behavior of the column user interface (UI), such as column width and cell style. For more information about cell styles, see Cell Styles in the Windows Forms DataGridView Control.
Types that derive from DataGridViewColumn typically initialize the CellTemplate property to a new instance of a related type derived from the DataGridViewCell class. Any column properties that relate to the appearance or behavior of individual cells are wrappers for the corresponding properties of the template cell. Changing one of these properties on the column automatically changes the value on the cell template and on all cells in the column. To override the specified value for individual cells, set the cell values after you set the column value.
Notes to Inheritors:
When you derive from DataGridViewColumn and add new properties to the derived class, be sure to override the Clone method to copy the new properties during cloning operations. You should also call the base class's Clone method so that the properties of the base class are copied to the new cell.
The following code example creates a Windows Form with a DataGridView and a set of buttons. Each button label describes an operation related to a DataGridViewColumn property, such as swapping the first and last column (using the DisplayIndex property) or changing the text of a column header (using the HeaderText property). Clicking a button changes the associated property of the DataGridViewColumn.
Available since 2.0
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.




