DataGridViewRowCollection.AddCopy(Int32) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
基于指定索引处的行添加新的一行。
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 事件之一的处理程序调用此方法:
- 或 -
DataGridView 的 DataSource 属性不是 null
。
- 或 -
此操作将在未冻结行之后添加一个冻结行。
注解
InheritedStyle新行的 属性的值与位于 indexSource
的行的值相同InheritedStyle。 如果可能,方法AddCopy将共享行添加到 。DataGridViewRowCollection 否则,新行将取消共享。 有关详细信息,请参阅 缩放 Windows 窗体 DataGridView 控件的最佳做法。
添加新行时,控件中的行不会自动排序。 若要将新行排序到正确的位置,请在事件处理程序中DataGridView.RowsAdded调用 DataGridView.Sort 方法。 你可能还希望在事件处理程序中CellValueChanged调用 DataGridView.Sort 方法,以在用户修改单元格时对行进行排序。