Add Method (String, String)
Collapse the table of content
Expand the table of content

DataGridViewColumnCollection.Add Method (String, String)


Adds a DataGridViewTextBoxColumn with the given column name and column header text to the collection.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public virtual int Add(
	string columnName,
	string headerText


Type: System.String

The name by which the column will be referred.

Type: System.String

The text for the column's header.

Return Value

Type: System.Int32

The index of the column.

Exception Condition

The associated DataGridView control is performing one of the following actions that temporarily prevents new columns from being added:

  • Selecting all cells in the control.

  • Clearing the selection.

  • Updating column DisplayIndex property values.


This method is being called from a handler for one of the following DataGridView events:


The DataGridView.SelectionMode property value is FullColumnSelect or ColumnHeaderSelect, which conflicts with the default column SortMode property value of Automatic.


The default column FillWeight property value of 100 would cause the combined FillWeight values of all columns in the control to exceed 65535.

The columnName and headerText parameters are related to the Name and HeaderText properties, respectively.

.NET Framework
Available since 2.0
Return to top
© 2016 Microsoft