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
)

Parameters

columnName
Type: System::String^

The name by which the column will be referred.

headerText
Type: System::String^

The text for the column's header.

Return Value

Type: System::Int32

The index of the column.

Exception Condition
InvalidOperationException

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.

-or-

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

-or-

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

-or-

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
Show: