Поделиться через


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 -> unit
Public 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 -> unit
Public 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[] -> unit
Public 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 событий для сортировки строк, когда пользователь изменяет ячейку.

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

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