DataGridViewRowCollection.Insert Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вставляет одну или несколько строк в коллекцию.
Перегрузки
| Insert(Int32, DataGridViewRow) |
Вставляет заданный объект DataGridViewRow в коллекцию. |
| Insert(Int32, Int32) |
Вставляет указанное количество строк в коллекцию в указанном месте. |
| Insert(Int32, Object[]) |
Вставляет новую строку в коллекцию в указанной позиции и заполняет ячейки заданными объектами. |
Insert(Int32, DataGridViewRow)
Вставляет заданный объект DataGridViewRow в коллекцию.
public:
virtual void Insert(int rowIndex, System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);public virtual void Insert (int rowIndex, System.Windows.Forms.DataGridViewRow dataGridViewRow);abstract member Insert : int * System.Windows.Forms.DataGridViewRow -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewRow -> unitPublic Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)Параметры
- rowIndex
- Int32
Позиция, в которой нужно вставить строку.
- dataGridViewRow
- DataGridViewRow
Объект DataGridViewRow, вставляемый в DataGridViewRowCollection.
Исключения
Значение rowIndex меньше нуля или больше количества строк в коллекции.
dataGridViewRow имеет значение null.
Связанный элемент управления DataGridView выполняет одно из следующих действий, которое временно предотвращает добавление новых строк:
Выделение всех ячеек в элементе управления .
Очистка выделенного фрагмента.
-или-
Этот метод вызывается из обработчика для одного из следующих событий DataGridView:
-или-
Свойство DataSource параметра DataGridView не равно null.
-или-
rowIndex равно числу строк в коллекции, а для свойства AllowUserToAddRows объекта DataGridView задано значение true.
-или-
Таблица DataGridView не содержит столбцов.
-или-
Свойство DataGridView элемента управления dataGridViewRow не равно null.
-или-
Параметр dataGridViewRow имеет значение true свойства Selected.
-или-
Эта операция вставляет зафиксированную строку после незафиксированных либо незафиксированную строку перед зафиксированными.
dataGridViewRow содержит больше ячеек, чем число столбцов в элементе управления.
Комментарии
Метод Insert(Int32, DataGridViewRow) добавляет общую строку в DataGridViewRowCollection, если это возможно. В противном случае новая строка будет отключена. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.
Строки в элементе управления не сортируются автоматически при добавлении новых строк. Чтобы отсортировать новые строки в правильное положение, вызовите DataGridView.Sort метод в обработчике DataGridView.RowsAdded событий. Также может потребоваться вызвать DataGridView.Sort метод в обработчике CellValueChanged событий для сортировки строк, когда пользователь изменяет ячейку.
См. также раздел
Применяется к
Insert(Int32, Int32)
Вставляет указанное количество строк в коллекцию в указанном месте.
public:
virtual void Insert(int rowIndex, int count);public virtual void Insert (int rowIndex, int count);abstract member Insert : int * int -> unit
override this.Insert : int * int -> unitPublic Overridable Sub Insert (rowIndex As Integer, count As Integer)Параметры
- rowIndex
- Int32
Позиция, в которую нужно вставить строки.
- count
- Int32
Количество строк для вставки в DataGridViewRowCollection.
Исключения
Значение rowIndex меньше нуля или больше количества строк в коллекции.
-или-
Значение параметраcount меньше 1.
Связанный элемент управления DataGridView выполняет одно из следующих действий, которое временно предотвращает добавление новых строк:
Выделение всех ячеек в элементе управления .
Очистка выделенного фрагмента.
-или-
Этот метод вызывается из обработчика для одного из следующих событий DataGridView:
-или-
Свойство DataSource параметра DataGridView не равно null.
-или-
Таблица DataGridView не содержит столбцов.
-или-
rowIndex равно числу строк в коллекции, а для свойства AllowUserToAddRows объекта DataGridView задано значение true.
-или-
Строка, возвращенная свойством RowTemplate, имеет больше ячеек, чем количество столбцов в элементе управления.
-или-
Эта операция вставляет зафиксированную строку после незафиксированных либо незафиксированную строку перед зафиксированными.
Комментарии
Метод Insert(Int32, Int32) добавляет строки, основанные RowTemplateDataGridViewна . Новая строка будет совместно использоваться, если это возможно. Убедитесь, что строка, указанная в свойстве , может быть совместно предоставлена RowTemplate для оптимальной масштабируемости. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.
Строки в элементе управления не сортируются автоматически при добавлении новых строк. Чтобы отсортировать новые строки в правильное положение, вызовите DataGridView.Sort метод в обработчике DataGridView.RowsAdded событий. Также может потребоваться вызвать DataGridView.Sort метод в обработчике CellValueChanged событий для сортировки строк, когда пользователь изменяет ячейку.
См. также раздел
Применяется к
Insert(Int32, Object[])
Вставляет новую строку в коллекцию в указанной позиции и заполняет ячейки заданными объектами.
public:
virtual void Insert(int rowIndex, ... cli::array <System::Object ^> ^ values);public virtual void Insert (int rowIndex, params object[] values);abstract member Insert : int * obj[] -> unit
override this.Insert : int * obj[] -> unitPublic Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())Параметры
- rowIndex
- Int32
Позиция, в которой нужно вставить строку.
- values
- Object[]
Переменное число объектов, которые заполняют ячейки новой строки.
Исключения
Значение rowIndex меньше нуля или больше количества строк в коллекции.
values имеет значение null.
Связанный элемент управления DataGridView выполняет одно из следующих действий, которое временно предотвращает добавление новых строк:
Выделение всех ячеек в элементе управления .
Очистка выделенного фрагмента.
-или-
Этот метод вызывается из обработчика для одного из следующих событий DataGridView:
-или-
Свойство VirtualMode объекта DataGridView имеет значение true.
-или-
Свойство DataSource параметра DataGridView не равно null.
-или-
Таблица DataGridView не содержит столбцов.
-или-
rowIndex равно числу строк в коллекции, а для свойства AllowUserToAddRows объекта DataGridView задано значение true.
-или-
Свойство DataGridView строки, возвращаемой свойством RowTemplate элемента управления, не имеет значения null.
-или-
Эта операция вставляет зафиксированную строку после незафиксированных либо незафиксированную строку перед зафиксированными.
Строка, возвращенная свойством RowTemplate элемента управления, имеет больше ячеек, чем количество столбцов в элементе управления.
Комментарии
Метод Insert(Int32, Object[]) добавляет строку без общего доступа в DataGridViewRowCollection.
Строки в элементе управления не сортируются автоматически при добавлении новых строк. Чтобы отсортировать новые строки в правильное положение, вызовите DataGridView.Sort метод в обработчике DataGridView.RowsAdded событий. Также может потребоваться вызвать DataGridView.Sort метод в обработчике CellValueChanged событий для сортировки строк, когда пользователь изменяет ячейку.
