DataGridViewRowCollection.IList.Add(Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет DataGridViewRow в коллекцию.
virtual int System.Collections.IList.Add(System::Object ^ value) = System::Collections::IList::Add;
int IList.Add (object value);
int IList.Add (object? value);
abstract member System.Collections.IList.Add : obj -> int
override this.System.Collections.IList.Add : obj -> int
Function Add (value As Object) As Integer Implements IList.Add
Параметры
Возвращаемое значение
Индекс новой строки DataGridViewRow.
Реализации
Исключения
value
не является объектом типа DataGridViewRow.
Связанный элемент управления DataGridView выполняет одно из следующих действий, которое временно предотвращает добавление новых строк:
Выделение всех ячеек в элементе управления .
Очистка выделенного фрагмента.
-или-
Этот метод вызывается из обработчика для одного из следующих событий DataGridView:
-или-
Свойство DataSource параметра DataGridView не равно null
.
-или-
Таблица DataGridView не содержит столбцов.
-или-
Свойство DataGridView параметра value
не равно null
.
-или-
Параметр value
имеет значение true
свойства Selected.
-или-
Эта операция добавит зафиксированную строку после незафиксированных.
value
имеет значение null
.
value
содержит больше ячеек, чем число столбцов в элементе управления.
Комментарии
Этот метод является явной реализацией члена интерфейса. Он может использоваться, только если экземпляр DataGridViewRowCollection приведен к типу интерфейса IList.
Этот метод вызывает перегрузкуAdd(DataGridViewRow), передавая value
ее после приведения к .DataGridViewRow
Строки в элементе управления не сортируются автоматически при добавлении новых строк. Чтобы отсортировать новые строки в правильное положение, вызовите DataGridView.Sort метод в обработчике DataGridView.RowsAdded событий. Также может потребоваться вызвать DataGridView.Sort метод в обработчике CellValueChanged событий, чтобы отсортировать строки, когда пользователь изменяет ячейку.
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по