DataGridViewRowCollection.Insert Метод

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Вставляет одну или несколько строк в коллекцию.

Перегрузки

Insert(Int32, DataGridViewRow)	Вставляет заданный объект DataGridViewRow в коллекцию.
Insert(Int32, Int32)	Вставляет указанное количество строк в коллекцию в указанном месте.
Insert(Int32, Object[])	Вставляет новую строку в коллекцию в указанной позиции и заполняет ячейки заданными объектами.

Insert(Int32, DataGridViewRow)

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

DataGridViewRowCollection.cs

Вставляет заданный объект 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.

Исключения

ArgumentOutOfRangeException

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

ArgumentNullException

dataGridViewRow имеет значение null.

InvalidOperationException

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

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

• Очистка выделенного фрагмента.

-или-

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-или-

Свойство DataSource параметра DataGridView не равно null.

-или-

rowIndex равно числу строк в коллекции, а для свойства AllowUserToAddRows объекта DataGridView задано значение true.

-или-

Таблица DataGridView не содержит столбцов.

-или-

Свойство DataGridView элемента управления dataGridViewRow не равно null.

-или-

Параметр dataGridViewRow имеет значение true свойства Selected.

-или-

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

ArgumentException

dataGridViewRow содержит больше ячеек, чем число столбцов в элементе управления.

Комментарии

Метод Insert(Int32, DataGridViewRow) добавляет общую строку в DataGridViewRowCollection, если это возможно. В противном случае новая строка будет отключена. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.

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

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

• DataGridView
• DataGridViewRow

Insert(Int32, Int32)

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

DataGridViewRowCollection.cs

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

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.

Исключения

ArgumentOutOfRangeException

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

-или-

Значение параметраcount меньше 1.

InvalidOperationException

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

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

• Очистка выделенного фрагмента.

-или-

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-или-

Свойство DataSource параметра DataGridView не равно null.

-или-

Таблица DataGridView не содержит столбцов.

-или-

rowIndex равно числу строк в коллекции, а для свойства AllowUserToAddRows объекта DataGridView задано значение true.

-или-

Строка, возвращенная свойством RowTemplate, имеет больше ячеек, чем количество столбцов в элементе управления.

-или-

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

Комментарии

Метод Insert(Int32, Int32) добавляет строки, основанные RowTemplateDataGridViewна . Новая строка будет совместно использоваться, если это возможно. Убедитесь, что строка, указанная в свойстве , может быть совместно предоставлена RowTemplate для оптимальной масштабируемости. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.

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

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

• DataGridView
• DataGridViewRow

Insert(Int32, Object[])

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

DataGridViewRowCollection.cs

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

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[]

Переменное число объектов, которые заполняют ячейки новой строки.

Исключения

ArgumentOutOfRangeException

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

ArgumentNullException

values имеет значение null.

InvalidOperationException

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

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

• Очистка выделенного фрагмента.

-или-

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-или-

Свойство VirtualMode объекта DataGridView имеет значение true.

-или-

Свойство DataSource параметра DataGridView не равно null.

-или-

Таблица DataGridView не содержит столбцов.

-или-

rowIndex равно числу строк в коллекции, а для свойства AllowUserToAddRows объекта DataGridView задано значение true.

-или-

Свойство DataGridView строки, возвращаемой свойством RowTemplate элемента управления, не имеет значения null.

-или-

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

ArgumentException

Строка, возвращенная свойством RowTemplate элемента управления, имеет больше ячеек, чем количество столбцов в элементе управления.

Комментарии

Метод Insert(Int32, Object[]) добавляет строку без общего доступа в DataGridViewRowCollection.

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

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

• DataGridView
• DataGridViewRow