DataGridViewRowCollection.AddCopy(Int32) 方法

定义

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

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

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

返回

新行的索引。

例外

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

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

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

  • 清除所选内容。

- 或 -

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

- 或 -

DataGridViewDataSource 属性不是 null

- 或 -

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

注解

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

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

适用于

另请参阅