DataGridViewRowCollection.AddCopy(Int32) Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Přidá nový řádek na základě řádku v zadaném indexu.

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

Parametry

indexSource

Int32

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

Návraty

Int32

Index nového řádku.

Výjimky

ArgumentOutOfRangeException

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

InvalidOperationException

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

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

• Vymaže se výběr.

-nebo-

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

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-nebo-

Vlastnost DataSourceDataGridView není null.

-nebo-

Tato operace by po zrušení zmrazování řádků přidala ukotvený řádek.

Poznámky

Vlastnost InheritedStyle nového řádku má stejné hodnoty jako InheritedStyle u řádku umístěného na indexSource. Metoda AddCopy 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. Pokud chcete 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 k seřazení řádků, když uživatel upraví buňku.

Viz také

• DataGridView
• DataGridViewRow