DataGridViewRowCollection.AddCopy(Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет новую строку на основе строки по указанному индексу.
public:
virtual int AddCopy(int indexSource);public virtual int AddCopy(int indexSource);abstract member AddCopy : int -> int
override this.AddCopy : int -> intPublic Overridable Function AddCopy (indexSource As Integer) As IntegerПараметры
- indexSource
- Int32
Индекс строки, на которой будет основываться новая строка.
Возвращаемое значение
Индекс новой строки.
Исключения
indexSource значение меньше нуля или больше или равно количеству строк в коллекции.
Связанный DataGridView элемент управления выполняет одно из следующих действий, которые временно препятствуют добавлению новых строк:
Выбор всех ячеек в элементе управления.
Очистка выделения.
–или–
Этот метод вызывается из обработчика для одного из следующих DataGridView событий:
–или–
Свойство DataSource не DataGridViewnullявляется .
–или–
Эта операция добавит замороженную строку после отмены работы строк.
Комментарии
Свойство InheritedStyle новой строки имеет те же значения, что InheritedStyle и строка, расположенная в indexSource. Если это возможно, AddCopy метод добавляет общую строку в нее DataGridViewRowCollection. В противном случае новая строка не используется. Дополнительные сведения см. в рекомендациях по масштабированию элемента управления DataGridView в Windows Forms.
Строки в элементе управления не отсортированы автоматически при добавлении новых строк. Чтобы сортировать новые строки в правильное положение, вызовите DataGridView.Sort метод в обработчике DataGridView.RowsAdded событий. Также может потребоваться вызвать DataGridView.Sort метод в CellValueChanged обработчике событий, чтобы отсортировать строки при изменении ячейки пользователем.
