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