DataGridViewRowCollection.AddCopy(Int32) Метод

  • Ссылка

Определение

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

Добавляет новую строку, основанную на строке по указанному индексу.

public:
 virtual int AddCopy(int indexSource);
public virtual int AddCopy (int indexSource);
abstract member AddCopy : int -> int
override this.AddCopy : int -> int
Public Overridable Function AddCopy (indexSource As Integer) As Integer

Параметры

indexSource
Int32

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

Возвращаемое значение

Int32

Индекс новой строки.

Исключения

ArgumentOutOfRangeException

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

InvalidOperationException

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

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

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

-или-

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

-или-

Свойство DataSource параметра DataGridView не равно null.

-или-

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

Комментарии

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

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

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

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