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

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

DataGridViewRowCollection.cs

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

public:
 virtual void InsertCopies(int indexSource, int indexDestination, int count);

public virtual void InsertCopies(int indexSource, int indexDestination, int count);

abstract member InsertCopies : int * int * int -> unit
override this.InsertCopies : int * int * int -> unit

Public Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)

Параметры

indexSource

Int32

Индекс, DataGridViewRow на котором будут основываться новые строки.

indexDestination

Int32

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

count

Int32

Количество DataGridViewRow объектов, добавляемых в объект DataGridViewRowCollection.

Исключения

ArgumentOutOfRangeException

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

–или–

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

–или–

count меньше 1.

InvalidOperationException

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

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

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

–или–

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

–или–

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

–или–

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

Комментарии

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

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

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

• DataGridView
• DataGridViewRow