DataGridViewColumnCollection::IList::Add Method (Object^)
This API supports the product infrastructure and is not intended to be used directly from your code.
Adds an object to the end of the collection.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Parameters
- value
-
Type:
System::Object^
The Object to add to the end of the collection. The value can be null.
Implements
IList::Add(Object^)| Exception | Condition |
|---|---|
| InvalidCastException | value is not a DataGridViewColumn. |
| ArgumentNullException | value 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- The column indicated by value already belongs to a DataGridView control. -or- The SortMode property value of the column indicated by 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 InheritedAutoSizeMode property value of the column indicated by value is ColumnHeader and the DataGridView::ColumnHeadersVisible property value is false. -or- The column indicated by value has an InheritedAutoSizeMode property value of Fill and a Frozen property value of true. -or- The column indicated by value has a FillWeight property value that would cause the combined FillWeight values of all columns in the control to exceed 65535. -or- The column indicated by value 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 the column indicated by value has a CellType property value of null. |
This member is an explicit interface member implementation. It can be used only when the DataGridViewColumnCollection instance is cast to an IList interface.
Available since 2.0