DataGridViewRowCollection.InsertCopy(Int32, Int32) 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

基于指定位置的行，将行插入指定位置的集合中。

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 -> unit

Public Overridable Sub InsertCopy (indexSource As Integer, indexDestination As Integer)

参数

indexSource

Int32

新行将以其为基础的行的索引。

indexDestination

Int32

要插入行的位置。

例外

ArgumentOutOfRangeException

indexSource 小于零或大于集合中的行数减一。

- 或 -

indexDestination 小于零或大于集合中的行数。

InvalidOperationException

关联的 DataGridView 控件正在执行以下操作之一，该操作暂时禁止添加新行：

• 选择控件中的所有单元格。

• 清除所选内容。

- 或 -

正在从以下 DataGridView 事件之一的处理程序调用此方法：

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- 或 -

indexDestination 等于集合中的行数，且 AllowUserToAddRows 为 true。

- 或 -

此操作将在未冻结的行之后插入一个冻结的行，或在冻结的行之前插入一个未冻结的行。

注解

此方法为新行分配参数中指定的 indexDestination 索引，并增加所有后续行的索引。 InheritedStyle新 DataGridViewRow 的 属性的值与位于 处indexSource的 具有相同DataGridViewRow的值InheritedStyle。 如果 InsertCopy 可能， 方法将共享行添加到 DataGridViewRowCollection。 否则，新行是非共享的。 有关详细信息，请参阅 缩放 Windows 窗体 DataGridView 控件的最佳做法。

添加新行时，控件中的行不会自动排序。 若要将新行排序到正确的位置，请在事件处理程序中DataGridView.RowsAdded调用 DataGridView.Sort 方法。 用户修改单元格时，可能还需要在事件处理程序中CellValueChanged调用 DataGridView.Sort 方法来对行进行排序。

另请参阅

• DataGridView
• DataGridViewRow