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 не DataGridViewnullявляется .

–или–

rowIndex равно числу строк в коллекции, а AllowUserToAddRows свойству DataGridViewtrueзадано значение .

–или–

У него DataGridView нет столбцов.

–или–

Свойство DataGridViewdataGridViewRow не nullявляется .

–или–

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

–или–

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

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 не DataGridViewnullявляется .

–или–

У него DataGridView нет столбцов.

–или–

rowIndex равно числу строк в коллекции, а AllowUserToAddRows свойству DataGridViewtrueзадано значение .

–или–

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

–или–

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

Комментарии

Метод Insert(Int32, Int32) добавляет строки, основанные на RowTemplate объекте DataGridView. Новая строка предоставляется по возможности. Убедитесь, что строка, указанная в свойстве 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 не DataGridViewnullявляется .

–или–

У него DataGridView нет столбцов.

–или–

rowIndex равно числу строк в коллекции, а AllowUserToAddRows свойству DataGridViewtrueзадано значение .

–или–

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

–или–

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

ArgumentException

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

Комментарии

Метод Insert(Int32, Object[]) добавляет в несоотделенные DataGridViewRowCollectionстроки.

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

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

• DataGridView
• DataGridViewRow