DataGridViewRowCollection::IList::Insert Method (Int32, Object^)
Inserts a DataGridViewRow into the collection at the specified index.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Parameters
- index
-
Type:
System::Int32
The zero-based index at which value should be inserted.
- value
-
Type:
System::Object^
The DataGridViewRow to insert into the DataGridViewRowCollection.
Implements
IList::Insert(Int32, Object^)| Exception | Condition |
|---|---|
| InvalidCastException | value is not a DataGridViewRow. |
| ArgumentOutOfRangeException | index is less than zero or greater than the number of rows in the collection. |
| ArgumentNullException | value is null. |
| 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- index is equal to the number of rows in the collection and the AllowUserToAddRows property of the DataGridView is set to true. -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 insert a frozen row after unfrozen rows or an unfrozen row before frozen rows. |
| ArgumentException | value has more cells than there are columns in the control. |
This member 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 Insert(Int32, 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