DataGridViewRowCollection.IList.Insert(Int32, Object) Метод

  • Ссылка

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

Вставляет в коллекцию объект DataGridViewRow по указанному индексу.

 virtual void System.Collections.IList.Insert(int index, System::Object ^ value) = System::Collections::IList::Insert;
void IList.Insert (int index, object value);
void IList.Insert (int index, object? value);
abstract member System.Collections.IList.Insert : int * obj -> unit
override this.System.Collections.IList.Insert : int * obj -> unit
Sub Insert (index As Integer, value As Object) Implements IList.Insert

Параметры

index
Int32

Отсчитываемый от нуля индекс, по которому следует вставить элемент value.

value
Object

Объект DataGridViewRow, вставляемый в DataGridViewRowCollection.

Реализации

Insert(Int32, Object)

Исключения

InvalidCastException

value не является объектом типа DataGridViewRow.

ArgumentOutOfRangeException

Значение index меньше нуля или больше количества строк в коллекции.

ArgumentNullException

value имеет значение null.

InvalidOperationException

Связанный элемент управления DataGridView выполняет одно из следующих действий, которое временно предотвращает добавление новых строк:

  • Выделение всех ячеек в элементе управления .

  • Очистка выделенного фрагмента.

-или-

Этот метод вызывается из обработчика для одного из следующих событий DataGridView:

-или-

Свойство DataSource параметра DataGridView не равно null.

-или-

index равно числу строк в коллекции, а для свойства AllowUserToAddRows объекта DataGridView задано значение true.

-или-

Таблица DataGridView не содержит столбцов.

-или-

Свойство DataGridView параметра value не равно null.

-или-

Параметр value имеет значение true свойства Selected.

-или-

Эта операция вставляет зафиксированную строку после незафиксированных либо незафиксированную строку перед зафиксированными.

ArgumentException

value содержит больше ячеек, чем число столбцов в элементе управления.

Комментарии

Этот член представляет собой явную реализацию члена интерфейса. Он может использоваться, только если экземпляр DataGridViewRowCollection приведен к типу интерфейса IList.

Этот метод вызывает перегрузку Insert(Int32, DataGridViewRow) , передавая значение после приведения его к DataGridViewRow.

Строки в элементе управления не сортируются автоматически при добавлении новых строк. Чтобы отсортировать новые строки в правильное положение, вызовите DataGridView.Sort метод в обработчике DataGridView.RowsAdded событий. Также может потребоваться вызвать DataGridView.Sort метод в обработчике CellValueChanged событий для сортировки строк, когда пользователь изменяет ячейку.

Применяется к

См. также раздел