DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将行插入集合中的指定位置。
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 -> unitPublic Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)参数
- indexSource
- Int32
要在上面放置新行的 DataGridViewRow 的索引。
- indexDestination
- Int32
要插入行的位置。
- count
- Int32
要添加到 DataGridViewRowCollection 的 DataGridViewRow 对象的数目。
例外
indexSource 小于零或大于集合中的行数减一。
- 或 -
indexDestination 小于零或大于集合中的行数。
- 或 -
count 小于 1。
关联的 DataGridView 控件正在执行以下操作之一，该操作暂时禁止添加新行：
选择控件中的所有单元格。
清除所选内容。
- 或 -
正在从以下 DataGridView 事件之一的处理程序调用此方法：
- 或 -
indexDestination 等于集合中的行数，且 AllowUserToAddRows 为 true。
- 或 -
此操作在未冻结的行之后插入一些冻结的行，或在冻结的行之前插入一些未冻结的行。
注解
InheritedStyle新 DataGridViewRow 对象的 属性的值与位于 处indexSource的 具有相同DataGridViewRow的值InheritedStyle。 如果 InsertCopies 可能， 方法将共享行添加到 DataGridViewRowCollection。 否则，新行将取消共享。 有关详细信息，请参阅 缩放 Windows 窗体 DataGridView 控件的最佳做法。
添加新行时，控件中的行不会自动排序。 若要将新行排序到正确的位置，请在事件处理程序中DataGridView.RowsAdded调用 DataGridView.Sort 方法。 用户修改单元格时，可能还需要在事件处理程序中CellValueChanged调用 DataGridView.Sort 方法来对行进行排序。
