Export (0) Print
Expand All

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.


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

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

© 2014 Microsoft