DataGridViewRowCollection.InsertCopy(Int32, Int32) Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Vloží řádek do kolekce na zadanou pozici na základě řádku na zadané pozici.

public:
 virtual void InsertCopy(int indexSource, int indexDestination);

public virtual void InsertCopy (int indexSource, int indexDestination);

abstract member InsertCopy : int * int -> unit
override this.InsertCopy : int * int -> unit

Public Overridable Sub InsertCopy (indexSource As Integer, indexDestination As Integer)

Parametry

indexSource

Int32

Index řádku, na kterém má být nový řádek založen.

indexDestination

Int32

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

Výjimky

ArgumentOutOfRangeException

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.

InvalidOperationException

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í:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-nebo-

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

-nebo-

Tato operace by vložila ukotvený řádek po rozbalené řádky nebo řádek před ukotvené řádky.

Poznámky

Tato metoda přiřadí novému řádku index zadaný v parametru indexDestination a zvýší indexy pro všechny následující řádky. Vlastnost InheritedStyle nového DataGridViewRow má stejné hodnoty jako InheritedStyle vlastnost umístěná DataGridViewRow na indexSource. Metoda InsertCopy přidá sdílený řádek do DataGridViewRowCollection, pokud je to možné. V opačném případě se nový řádek nesdílí. 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.

Viz také

• DataGridView
• DataGridViewRow