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

  • Ссылка

Определение

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

Вставляет строки в коллекцию в указанною позицию.

public:
 virtual void InsertCopies(int indexSource, int indexDestination, int count);
public virtual void InsertCopies (int indexSource, int indexDestination, int count);
abstract member InsertCopies : int * int * int -> unit
override this.InsertCopies : int * int * int -> unit
Public Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)

Параметры

indexSource
Int32

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

indexDestination
Int32

Позиция, в которую нужно вставить строки.

count
Int32

Количество объектов DataGridViewRow, которое необходимо добавить в DataGridViewRowCollection.

Исключения

ArgumentOutOfRangeException

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

-или-

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

-или-

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

InvalidOperationException

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

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

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

-или-

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

-или-

indexDestination равно числу строк в коллекции, а AllowUserToAddRows равно true.

-или-

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

Комментарии

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

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

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

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