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í

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()

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

• 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-

Pole DataGridView neobsahuje žádné sloupce.

-nebo-

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

ArgumentException

Řádek vrácený RowTemplate vlastností obsahuje více buněk, než je sloupců v ovládacím prvku.

Poznámky

Přetížení Add() přidá řádky, které jsou založené na RowTemplate objektu DataGridView. Pokud je to možné, nový řádek se sdílí. Ujistěte se, že řádek zadaný ve RowTemplate vlastnosti lze sdílet pro zajištění co nejlepší škálovatelnosti. 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
• Doporučené postupy pro změnu velikosti v ovládacím prvku Windows Forms DataGridView

Add(Int32)

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

• 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-

Pole DataGridView neobsahuje žádné sloupce.

-nebo-

Řádek vrácený RowTemplate vlastností obsahuje více buněk, než je sloupců v ovládacím prvku.

-nebo-

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

Poznámky

Metoda Add(Int32) přidá sdílené řádky do objektu DataGridViewRowCollection. Nové řádky jsou založené na objektu RowTemplateDataGridView. Ujistěte se, že řádek zadaný ve RowTemplate vlastnosti lze sdílet pro zajištění co nejlepší škálovatelnosti. 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

Add(Object[])

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ěnlivý počet objektů, které naplní buňky nového DataGridViewRowobjektu .

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

• 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 VirtualMode objektu je nastavená DataGridView na true.

-nebo-

Vlastnost DataSourceDataGridView není null.

-nebo-

Pole DataGridView neobsahuje žádné sloupce.

-nebo-

Řádek vrácený RowTemplate vlastností obsahuje více buněk, než je sloupců v ovládacím prvku.

-nebo-

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

Poznámky

Metoda Add(Object[]) přidá nesdílený řádek do objektu DataGridViewRowCollection. 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

Add(DataGridViewRow)

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

Chcete-li DataGridViewRow přidat do DataGridViewRowCollection.

Návraty

Int32

Index nového DataGridViewRowobjektu .

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

• 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-

Pole DataGridView neobsahuje žádné sloupce.

-nebo-

Vlastnost DataGridViewdataGridViewRow není null.

-nebo-

dataGridViewRowSelected má hodnotu truevlastnosti .

-nebo-

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

ArgumentNullException

dataGridViewRow je null.

ArgumentException

dataGridViewRow obsahuje více buněk, než je počet sloupců v ovládacím prvku.

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 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
• DataGridViewColumn
• CellTemplate
• Doporučené postupy pro změnu velikosti v ovládacím prvku Windows Forms DataGridView