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 не DataGridViewnullявляется .

–или–

У него DataGridView нет столбцов.

–или–

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

ArgumentException

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

Комментарии

Перегрузка Add() добавляет строки, основанные на RowTemplate объекте DataGridView. Новая строка предоставляется по возможности. Убедитесь, что строка, указанная в свойстве 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 не DataGridViewnullявляется .

–или–

У него 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 не DataGridViewnullявляется .

–или–

У него 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 не DataGridViewnullявляется .

–или–

У него DataGridView нет столбцов.

–или–

Свойство DataGridView не dataGridViewRownullявляется .

–или–

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

–или–

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

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