DataGridViewRowCollection.Add Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Добавляет одну или больше строк в коллекцию.

Перегрузки

Add()	Добавляет в коллекцию новую строку.
Add(Int32)	Добавляет указанное число новых строк в коллекцию.
Add(Object[])	Добавляет новую строку в коллекцию и заполняет ячейки заданными объектами.
Add(DataGridViewRow)	Добавляет указанный параметр DataGridViewRow в коллекцию.

Add()

Исходный код:

DataGridViewRowCollection.cs

Добавляет в коллекцию новую строку.

public:
 virtual int Add();

public virtual int Add ();

abstract member Add : unit -> int
override this.Add : unit -> int

Public Overridable Function Add () As Integer

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

Int32

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

Исключения

InvalidOperationException

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

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

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

-или-

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-или-

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

-или-

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

-или-

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

ArgumentException

Строка, возвращенная свойством RowTemplate, имеет больше ячеек, чем количество столбцов в элементе управления.

Комментарии

Перегрузка Add() добавляет строки, основанные на RowTemplateDataGridView. Новая строка будет совместно использоваться, если это возможно. Убедитесь, что строка, указанная в свойстве , может быть совместно предоставлена RowTemplate для оптимальной масштабируемости. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.

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

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

• DataGridView
• DataGridViewRow
• Масштабирование элемента управления DataGridView в Windows Forms

Add(Int32)

Исходный код:

DataGridViewRowCollection.cs

Добавляет указанное число новых строк в коллекцию.

public:
 virtual int Add(int count);

public virtual int Add (int count);

abstract member Add : int -> int
override this.Add : int -> int

Public Overridable Function Add (count As Integer) As Integer

Параметры

count

Int32

Количество строк, добавляемых в DataGridViewRowCollection.

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

Int32

Индекс последней добавленной строки.

Исключения

ArgumentOutOfRangeException

Значение параметраcount меньше 1.

InvalidOperationException

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

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

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

-или-

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-или-

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

-или-

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

-или-

Строка, возвращенная свойством RowTemplate, имеет больше ячеек, чем количество столбцов в элементе управления.

-или-

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

Комментарии

Метод Add(Int32) добавляет общие строки в DataGridViewRowCollection. Новые строки основаны на RowTemplateDataGridView. Убедитесь, что строка, указанная в свойстве , может быть совместно предоставлена RowTemplate для оптимальной масштабируемости. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.

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

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

• DataGridView
• DataGridViewRow

Add(Object[])

Исходный код:

DataGridViewRowCollection.cs

Добавляет новую строку в коллекцию и заполняет ячейки заданными объектами.

public:
 virtual int Add(... cli::array <System::Object ^> ^ values);

public virtual int Add (params object[] values);

abstract member Add : obj[] -> int
override this.Add : obj[] -> int

Public Overridable Function Add (ParamArray values As Object()) As Integer

Параметры

values

Object[]

Переменное число объектов, которые заполняют ячейки новой строки DataGridViewRow.

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

Int32

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

Исключения

ArgumentNullException

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

InvalidOperationException

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

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

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

-или-

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-или-

Свойство VirtualMode объекта DataGridView имеет значение true.

-или-

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

-или-

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

-или-

Строка, возвращенная свойством RowTemplate, имеет больше ячеек, чем количество столбцов в элементе управления.

-или-

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

Комментарии

Метод Add(Object[]) добавляет строку без общего доступа в DataGridViewRowCollection. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.

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

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

• DataGridView
• DataGridViewRow

Add(DataGridViewRow)

Исходный код:

DataGridViewRowCollection.cs

Добавляет указанный параметр DataGridViewRow в коллекцию.

public:
 virtual int Add(System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);

public virtual int Add (System.Windows.Forms.DataGridViewRow dataGridViewRow);

abstract member Add : System.Windows.Forms.DataGridViewRow -> int
override this.Add : System.Windows.Forms.DataGridViewRow -> int

Public Overridable Function Add (dataGridViewRow As DataGridViewRow) As Integer

Параметры

dataGridViewRow

DataGridViewRow

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

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

Int32

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

Исключения

InvalidOperationException

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

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

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

-или-

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-или-

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

-или-

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

-или-

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

-или-

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

-или-

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

ArgumentNullException

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

ArgumentException

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

Комментарии

Метод Add(DataGridViewRow) добавляет общую строку в DataGridViewRowCollection, если это возможно. В противном случае новая строка будет отключена. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.

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

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

• DataGridView
• DataGridViewRow
• DataGridViewColumn
• CellTemplate
• Масштабирование элемента управления DataGridView в Windows Forms