DataGridViewRowCollection.AddCopy(Int32) 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

基于指定索引处的行添加新的一行。

public:
 virtual int AddCopy(int indexSource);

public virtual int AddCopy (int indexSource);

abstract member AddCopy : int -> int
override this.AddCopy : int -> int

Public Overridable Function AddCopy (indexSource As Integer) As Integer

参数

indexSource

Int32

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

返回

Int32

新行的索引。

例外

ArgumentOutOfRangeException

indexSource 小于零，或者大于或等于集合中的行数。

InvalidOperationException

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

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

• 清除所选内容。

- 或 -

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- 或 -

DataGridView 的 DataSource 属性不是 null。

- 或 -

此操作将在未冻结行之后添加一个冻结行。

注解

InheritedStyle新行的 属性的值与位于 indexSource的行的值相同InheritedStyle。 如果可能，方法AddCopy将共享行添加到 。DataGridViewRowCollection 否则，新行将取消共享。 有关详细信息，请参阅 缩放 Windows 窗体 DataGridView 控件的最佳做法。

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

另请参阅

• DataGridView
• DataGridViewRow