DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вставляет строки в коллекцию в указанною позицию.
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 -> unitPublic Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)Параметры
- indexSource
- Int32
Индекс DataGridViewRow, который будет использоваться в качестве основы для новых строк.
- indexDestination
- Int32
Позиция, в которую нужно вставить строки.
- count
- Int32
Количество объектов DataGridViewRow, которое необходимо добавить в DataGridViewRowCollection.
Исключения
Значение indexSource меньше нуля или больше количества строк в коллекции минус 1.
-или-
Значение indexDestination меньше нуля или больше количества строк в коллекции.
-или-
Значение параметраcount меньше 1.
Связанный элемент управления DataGridView выполняет одно из следующих действий, которое временно предотвращает добавление новых строк:
Выделение всех ячеек в элементе управления .
Очистка выделенного фрагмента.
-или-
Этот метод вызывается из обработчика для одного из следующих событий DataGridView:
-или-
indexDestination равно числу строк в коллекции, а AllowUserToAddRows равно true.
-или-
Эта операция вставляет зафиксированные строки после незафиксированных либо вставляет незафиксированные строки перед зафиксированными.
Комментарии
Свойство InheritedStyle новых DataGridViewRow объектов имеет те же значения, что InheritedStyle и свойства объекта , DataGridViewRow расположенного в indexSource. Метод InsertCopies добавляет общие строки в DataGridViewRowCollection, если это возможно. В противном случае новые строки будут удалены. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.
Строки в элементе управления не сортируются автоматически при добавлении новых строк. Чтобы отсортировать новые строки в правильное положение, вызовите DataGridView.Sort метод в обработчике DataGridView.RowsAdded событий. Также может потребоваться вызвать DataGridView.Sort метод в обработчике CellValueChanged событий для сортировки строк, когда пользователь изменяет ячейку.
