DataGridViewRowCollection.AddCopies(Int32, Int32) Метод

  • Ссылка

Определение

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

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

public:
 virtual int AddCopies(int indexSource, int count);
public virtual int AddCopies (int indexSource, int count);
abstract member AddCopies : int * int -> int
override this.AddCopies : int * int -> int
Public Overridable Function AddCopies (indexSource As Integer, count As Integer) As Integer

Параметры

indexSource
Int32

Индекс строки, который будет использоваться в качестве основы для новых строк.

count
Int32

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

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

Int32

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

Исключения

ArgumentOutOfRangeException

Значение indexSource меньше нуля или больше либо равно количеству строк в элементе управления.

-или-

Значение параметра count меньше нуля.

InvalidOperationException

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

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

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

-или-

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

-или-

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

-или-

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

Комментарии

Свойство InheritedStyle нового DataGridViewRow объекта имеет те же значения, InheritedStyle что и свойства объекта , расположенного DataGridViewRow в indexSource. Метод AddCopies добавляет общие строки в DataGridViewRowCollection, если это возможно. В противном случае новые строки будут удалены. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.

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

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

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