DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) 方法

  • 参考

定义

命名空间:
System.Windows.Forms
程序集:
System.Windows.Forms.dll

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

public:
 virtual void InsertCopies(int indexSource, int indexDestination, int count);
public virtual void InsertCopies (int indexSource, int indexDestination, int count);
abstract member InsertCopies : int * int * int -> unit
override this.InsertCopies : int * int * int -> unit
Public Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)

参数

indexSource
Int32

要在上面放置新行的 DataGridViewRow 的索引。

indexDestination
Int32

要插入行的位置。

count
Int32

要添加到 DataGridViewRowCollection 的 DataGridViewRow 对象的数目。

例外

ArgumentOutOfRangeException

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

- 或 -

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

- 或 -

count 小于 1。

InvalidOperationException

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

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

  • 清除所选内容。

- 或 -

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

- 或 -

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

- 或 -

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

注解

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

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

适用于

另请参阅