DataGridViewColumnCollection::Insert Method (Int32, DataGridViewColumn^)

 

Inserts a column at the given index in the collection.

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

public:
virtual void Insert(
	int columnIndex,
	DataGridViewColumn^ dataGridViewColumn
)

Parameters

columnIndex
Type: System::Int32

The zero-based index at which to insert the given column.

dataGridViewColumn
Type: System.Windows.Forms::DataGridViewColumn^

The DataGridViewColumn to insert.

Exception Condition
ArgumentNullException

dataGridViewColumn is null.

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-

dataGridViewColumn already belongs to a DataGridView control.

-or-

The dataGridViewColumnSortMode property value is Automatic and the DataGridView::SelectionMode property value is FullColumnSelect or ColumnHeaderSelect. Use the control ISupportInitialize::BeginInit and ISupportInitialize::EndInit methods to temporarily set conflicting property values.

-or-

The dataGridViewColumnInheritedAutoSizeMode property value is ColumnHeader and the DataGridView::ColumnHeadersVisible property value is false.

-or-

dataGridViewColumn has an InheritedAutoSizeMode property value of Fill and a Frozen property value of true.

-or-

dataGridViewColumn has DisplayIndex and Frozen property values that would display it among a set of adjacent columns with the opposite Frozen property value.

-or-

The DataGridView control contains at least one row and dataGridViewColumn has a CellType property value of null.

The following code example illustrates the use of this method. For more information, see How to: Add an Unbound Column to a Data-Bound Windows Forms DataGridView Control.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top
Show: