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 параметра DataGridView не равно null.
-или-
Эта операция добавит зафиксированную строку после незафиксированных.
Комментарии
Свойство InheritedStyle новой строки имеет те же значения, что InheritedStyle и для строки, размещенной в indexSource. Метод AddCopy добавляет общую строку в DataGridViewRowCollection, если это возможно. В противном случае новая строка будет отключена. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.
Строки в элементе управления не сортируются автоматически при добавлении новых строк. Чтобы отсортировать новые строки в правильное положение, вызовите DataGridView.Sort метод в обработчике DataGridView.RowsAdded событий. Также может потребоваться вызвать DataGridView.Sort метод в обработчике CellValueChanged событий для сортировки строк, когда пользователь изменяет ячейку.
