DataGridViewRowCollection.IList.Add(Object) Метод

  • Ссылка

Определение

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

Добавляет 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

Параметры

value
Object

Объект Object, добавляемый в список IList.

Возвращаемое значение

Int32

Индекс новой строки DataGridViewRow.

Реализации

Add(Object)

Исключения

InvalidCastException

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

InvalidOperationException

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

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

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

-или-

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

-или-

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

-или-

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

-или-

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

-или-

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

-или-

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

ArgumentNullException

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

ArgumentException

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

Комментарии

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

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

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

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

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