DataGridViewRowCollection.IList.Insert(Int32, Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вставляет в коллекцию объект 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.
Реализации
Исключения
value
не является объектом типа DataGridViewRow.
Значение index
меньше нуля или больше количества строк в коллекции.
value
имеет значение null
.
Связанный элемент управления DataGridView выполняет одно из следующих действий, которое временно предотвращает добавление новых строк:
Выделение всех ячеек в элементе управления .
Очистка выделенного фрагмента.
-или-
Этот метод вызывается из обработчика для одного из следующих событий DataGridView:
-или-
Свойство DataSource параметра DataGridView не равно null
.
-или-
index
равно числу строк в коллекции, а для свойства AllowUserToAddRows объекта DataGridView задано значение true
.
-или-
Таблица DataGridView не содержит столбцов.
-или-
Свойство DataGridView параметра value
не равно null
.
-или-
Параметр value
имеет значение true
свойства Selected.
-или-
Эта операция вставляет зафиксированную строку после незафиксированных либо незафиксированную строку перед зафиксированными.
value
содержит больше ячеек, чем число столбцов в элементе управления.
Комментарии
Этот член представляет собой явную реализацию члена интерфейса. Он может использоваться, только если экземпляр DataGridViewRowCollection приведен к типу интерфейса IList.
Этот метод вызывает перегрузку Insert(Int32, DataGridViewRow) , передавая значение после приведения его к DataGridViewRow.
Строки в элементе управления не сортируются автоматически при добавлении новых строк. Чтобы отсортировать новые строки в правильное положение, вызовите DataGridView.Sort метод в обработчике DataGridView.RowsAdded событий. Также может потребоваться вызвать DataGridView.Sort метод в обработчике CellValueChanged событий для сортировки строк, когда пользователь изменяет ячейку.
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по