Sdílet prostřednictvím


DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) Metoda

Definice

Vloží řádky do kolekce na zadané pozici.

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)

Parametry

indexSource
Int32

Index objektu DataGridViewRow , na kterém mají být nové řádky založeny.

indexDestination
Int32

Pozice, na kterou chcete řádky vložit.

count
Int32

Počet DataGridViewRow objektů, které mají být přidány do objektu DataGridViewRowCollection.

Výjimky

indexSource je menší než nula nebo větší než počet řádků v kolekci minus jeden.

-nebo-

indexDestination je menší než nula nebo větší než počet řádků v kolekci.

-nebo-

count je menší než 1.

Přidružený DataGridView ovládací prvek provádí jednu z následujících akcí, která dočasně zabrání přidání nových řádků:

  • Výběr všech buněk v ovládacím prvku

  • Vymazání výběru

-nebo-

Tato metoda je volána z obslužné rutiny pro jednu z následujících DataGridView událostí:

-nebo-

indexDestination se rovná počtu řádků v kolekci a AllowUserToAddRows je true.

-nebo-

Tato operace vloží ukotvené řádky po rozmrazené řádky nebo řádky před ukotvené řádky.

Poznámky

Vlastnost InheritedStyle nových DataGridViewRow objektů má stejné hodnoty jako InheritedStyle vlastnost objektu umístěného DataGridViewRow v indexSource. Metoda InsertCopies přidá sdílené řádky do objektu DataGridViewRowCollection, pokud je to možné. V opačném případě se nové řádky nesdílejí. Další informace najdete v tématu Osvědčené postupy pro škálování ovládacího prvku model Windows Forms DataGridView.

Řádky v ovládacím prvku nejsou při přidání nových řádků automaticky seřazeny. Chcete-li seřadit nové řádky do správné pozice, zavolejte metodu DataGridView.Sort v obslužné rutině DataGridView.RowsAdded události. Můžete také volat metodu DataGridView.Sort v obslužné rutině CellValueChanged události, která seřadí řádky, když uživatel změní buňku.

Platí pro

Viz také