DataGridViewRowCollection.InsertCopy(Int32, Int32) Метод

  • Ссылка

Определение

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

Вставляет строку в коллекцию в указанной позиции на основе строки в указанной позиции.

public:
 virtual void InsertCopy(int indexSource, int indexDestination);
public virtual void InsertCopy (int indexSource, int indexDestination);
abstract member InsertCopy : int * int -> unit
override this.InsertCopy : int * int -> unit
Public Overridable Sub InsertCopy (indexSource As Integer, indexDestination As Integer)

Параметры

indexSource
Int32

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

indexDestination
Int32

Позиция, в которой нужно вставить строку.

Исключения

ArgumentOutOfRangeException

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

-или-

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

InvalidOperationException

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

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

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

-или-

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

-или-

indexDestination равно числу строк в коллекции, а AllowUserToAddRows равно true.

-или-

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

Комментарии

Этот метод назначает новой строке индекс, указанный в параметре indexDestination , и увеличивает индексы для всех последующих строк. Свойство InheritedStyle new DataGridViewRow имеет те же значения, InheritedStyle что и для объекта , расположенного DataGridViewRow в indexSource. Метод InsertCopy добавляет общую строку в DataGridViewRowCollection, если это возможно. В противном случае новая строка будет отключена. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.

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

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

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