DataGridViewRowCollection.Add Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Přidá do kolekce jeden nebo více řádků.

Přetížení

Name	Description
Add()	Přidá do kolekce nový řádek.
Add(Int32)	Přidá zadaný počet nových řádků do kolekce.
Add(Object[])	Přidá do kolekce nový řádek a naplní buňky zadanými objekty.
Add(DataGridViewRow)	Přidá zadaný DataGridViewRow objekt do kolekce.

Add()

Zdroj:

DataGridViewRowCollection.cs

Přidá do kolekce nový řádek.

public:
 virtual int Add();

public virtual int Add();

abstract member Add : unit -> int
override this.Add : unit -> int

Public Overridable Function Add () As Integer

Návraty

Int32

Index nového řádku.

Výjimky

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

• Vymazání výběru.

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

Neobsahuje DataGridView žádné sloupce.

nebo

Tato operace by přidala ukotvený řádek za řádky, které zrušíte.

ArgumentException

Řádek vrácený RowTemplate vlastností má více buněk, než jsou sloupce v ovládacím prvku.

Poznámky

Přetížení Add() přidá řádky, které jsou založeny RowTemplate na .DataGridView Pokud je to možné, nový řádek se sdílí. Ujistěte se, že řádek zadaný ve RowTemplate vlastnosti je možné sdílet, aby se zajistila nejlepší škálovatelnost. Další informace naleznete v tématu Osvědčené postupy pro škálování ovládacího prvku Windows Forms DataGridView.

Řádky v ovládacím prvku nejsou automaticky seřazeny při přidání nových řádků. Chcete-li seřadit nové řádky do správné pozice, zavolejte DataGridView.Sort metodu 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 upraví buňku.

Viz také

• DataGridView
• DataGridViewRow
• Osvědčené postupy pro škálování ovládacího prvku Windows Forms DataGridView

Add(Int32)

Zdroj:

DataGridViewRowCollection.cs

Přidá zadaný počet nových řádků do kolekce.

public:
 virtual int Add(int count);

public virtual int Add(int count);

abstract member Add : int -> int
override this.Add : int -> int

Public Overridable Function Add (count As Integer) As Integer

Parametry

count

Int32

Počet řádků, které se mají přidat do DataGridViewRowCollection.

Návraty

Int32

Index posledního přidaného řádku

Výjimky

ArgumentOutOfRangeException

count je menší než 1.

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

• Vymazání výběru.

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

Neobsahuje DataGridView žádné sloupce.

nebo

Řádek vrácený RowTemplate vlastností má více buněk, než jsou sloupce v ovládacím prvku.

nebo

Tato operace by přidala ukotvené řádky za řádky, které zrušíte.

Poznámky

Metoda Add(Int32) přidá sdílené řádky do DataGridViewRowCollection. Nové řádky jsou založeny na RowTemplate hodnotě DataGridView. Ujistěte se, že řádek zadaný ve RowTemplate vlastnosti je možné sdílet, aby se zajistila nejlepší škálovatelnost. Další informace naleznete v tématu Osvědčené postupy pro škálování ovládacího prvku Windows Forms DataGridView.

Řádky v ovládacím prvku nejsou automaticky seřazeny při přidání nových řádků. Chcete-li seřadit nové řádky do správné pozice, zavolejte DataGridView.Sort metodu 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 upraví buňku.

Viz také

• DataGridView
• DataGridViewRow

Add(Object[])

Zdroj:

DataGridViewRowCollection.cs

Přidá do kolekce nový řádek a naplní buňky zadanými objekty.

public:
 virtual int Add(... cli::array <System::Object ^> ^ values);

public virtual int Add(params object[] values);

abstract member Add : obj[] -> int
override this.Add : obj[] -> int

Public Overridable Function Add (ParamArray values As Object()) As Integer

Parametry

values

Object[]

Proměnný počet objektů, které naplňují buňky nového DataGridViewRow.

Návraty

Int32

Index nového řádku.

Výjimky

ArgumentNullException

values je null.

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

• Vymazání výběru.

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 VirtualMode objektu DataGridView je nastavena na hodnotu true.

nebo

Vlastnost DataSourceDataGridView není null.

nebo

Neobsahuje DataGridView žádné sloupce.

nebo

Řádek vrácený RowTemplate vlastností má více buněk, než jsou sloupce v ovládacím prvku.

nebo

Tato operace by přidala ukotvený řádek za řádky, které zrušíte.

Poznámky

Metoda Add(Object[]) přidá nesdílený řádek do DataGridViewRowCollection. Další informace naleznete v tématu Osvědčené postupy pro škálování ovládacího prvku Windows Forms DataGridView.

Řádky v ovládacím prvku nejsou automaticky seřazeny při přidání nových řádků. Chcete-li seřadit nové řádky do správné pozice, zavolejte DataGridView.Sort metodu 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 upraví buňku.

Viz také

• DataGridView
• DataGridViewRow

Add(DataGridViewRow)

Zdroj:

DataGridViewRowCollection.cs

Přidá zadaný DataGridViewRow objekt do kolekce.

public:
 virtual int Add(System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);

public virtual int Add(System.Windows.Forms.DataGridViewRow dataGridViewRow);

abstract member Add : System.Windows.Forms.DataGridViewRow -> int
override this.Add : System.Windows.Forms.DataGridViewRow -> int

Public Overridable Function Add (dataGridViewRow As DataGridViewRow) As Integer

Parametry

dataGridViewRow

DataGridViewRow

The DataGridViewRow to add to the DataGridViewRowCollection.

Návraty

Int32

Index nového DataGridViewRowsouboru .

Výjimky

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

• Vymazání výběru.

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

Neobsahuje DataGridView žádné sloupce.

nebo

Vlastnost DataGridViewdataGridViewRow není null.

nebo

dataGridViewRow Selected má hodnotu truevlastnosti .

nebo

Tato operace by přidala ukotvený řádek za řádky, které zrušíte.

ArgumentNullException

dataGridViewRow je null.

ArgumentException

dataGridViewRow obsahuje více buněk, než jsou v ovládacím prvku sloupce.

Poznámky

Metoda Add(DataGridViewRow) 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 naleznete v tématu Osvědčené postupy pro škálování ovládacího prvku Windows Forms DataGridView.

Řádky v ovládacím prvku nejsou automaticky seřazeny při přidání nových řádků. Chcete-li seřadit nové řádky do správné pozice, zavolejte DataGridView.Sort metodu 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 upraví buňku.

Viz také

• DataGridView
• DataGridViewRow
• DataGridViewColumn
• CellTemplate
• Osvědčené postupy pro škálování ovládacího prvku Windows Forms DataGridView