DataGridViewColumnCollection::Add Method (DataGridViewColumn^)
Adds the given column to the collection.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Parameters
- dataGridViewColumn
-
Type:
System.Windows.Forms::DataGridViewColumn^
The DataGridViewColumn to add.
| 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 a FillWeight property value that would cause the combined FillWeight values of all columns in the control to exceed 65535. -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. |
Available since 2.0