DataGridViewColumnCollection::Insert Method (Int32, DataGridViewColumn^)
Inserts a column at the given index in the collection.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
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:
-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.
Available since 2.0