DataGridViewRowCollection::IList::Add Method (Object^)
Adds a DataGridViewRow to the collection.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Parameters
- value
- Type: System::Object^
Implements
IList::Add(Object^)| Exception | Condition |
|---|---|
| InvalidCastException | value is not a DataGridViewRow. |
| InvalidOperationException | The associated DataGridView control is performing one of the following actions that temporarily prevents new rows from being added:
-or- This method is being called from a handler for one of the following DataGridView events: -or- The DataSource property of the DataGridView is not null. -or- The DataGridView has no columns. -or- The DataGridView property of the value is not null. -or- value has a Selected property value of true. -or- This operation would add a frozen row after unfrozen rows. |
| ArgumentNullException | value is null. |
| ArgumentException | value has more cells than there are columns in the control. |
This method is an explicit interface member implementation. It can be used only when the DataGridViewRowCollection instance is cast to an IList interface.
This method calls the Add(DataGridViewRow^) overload, passing in value after casting it to a DataGridViewRow.
Rows in the control are not automatically sorted when new rows are added. To sort new rows into their correct position, call the DataGridView::Sort method in a DataGridView::RowsAdded event handler. You might also want to call the DataGridView::Sort method in a CellValueChanged event handler to sort the rows when the user modifies a cell.
Available since 2.0