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

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGridViewRowCollection.cs

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

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 меньше нуля или больше числа строк в коллекции минус один.

–или–

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

InvalidOperationException

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

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

• Очистка выделения.

–или–

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

–или–

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

–или–

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

Комментарии

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

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

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

• DataGridView
• DataGridViewRow