DataGridViewRowCollection.InsertCopy(Int32, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вставляет строку в коллекцию в указанной позиции на основе строки в указанной позиции.
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 -> unitPublic Overridable Sub InsertCopy (indexSource As Integer, indexDestination As Integer)Параметры
- indexSource
- Int32
Индекс строки, который будет использоваться в качестве основы для новой строки.
- indexDestination
- Int32
Позиция, в которой нужно вставить строку.
Исключения
Значение indexSource меньше нуля или больше количества строк в коллекции минус 1.
-или-
Значение indexDestination меньше нуля или больше количества строк в коллекции.
Связанный элемент управления DataGridView выполняет одно из следующих действий, которое временно предотвращает добавление новых строк:
Выделение всех ячеек в элементе управления .
Очистка выделенного фрагмента.
-или-
Этот метод вызывается из обработчика для одного из следующих событий DataGridView:
-или-
indexDestination равно числу строк в коллекции, а AllowUserToAddRows равно true.
-или-
Эта операция вставляет зафиксированную строку после незафиксированных либо незафиксированную строку перед зафиксированными.
Комментарии
Этот метод назначает новой строке индекс, указанный в параметре indexDestination , и увеличивает индексы для всех последующих строк. Свойство InheritedStyle new DataGridViewRow имеет те же значения, InheritedStyle что и для объекта , расположенного DataGridViewRow в indexSource. Метод InsertCopy добавляет общую строку в DataGridViewRowCollection, если это возможно. В противном случае новая строка будет отключена. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.
Строки в элементе управления не сортируются автоматически при добавлении новых строк. Чтобы отсортировать новые строки в правильное положение, вызовите DataGridView.Sort метод в обработчике DataGridView.RowsAdded событий. Также может потребоваться вызвать DataGridView.Sort метод в обработчике CellValueChanged событий, чтобы отсортировать строки, когда пользователь изменяет ячейку.
