DataGridViewRowCollection.Insert Metoda

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Vloží jeden nebo více řádků do kolekce.

Přetížení

Insert(Int32, DataGridViewRow)

Vloží zadaný DataGridViewRow objekt do kolekce.
Insert(Int32, Int32)

Vloží zadaný počet řádků do kolekce v zadaném umístění.
Insert(Int32, Object[])

Vloží řádek do kolekce na zadanou pozici a naplní buňky zadanými objekty.

Insert(Int32, DataGridViewRow)

Vloží zadaný DataGridViewRow objekt do kolekce.

public:
 virtual void Insert(int rowIndex, System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);
public virtual void Insert (int rowIndex, System.Windows.Forms.DataGridViewRow dataGridViewRow);
abstract member Insert : int * System.Windows.Forms.DataGridViewRow -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewRow -> unit
Public Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)

Parametry

rowIndex
Int32

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

dataGridViewRow
DataGridViewRow

Vloží DataGridViewRow se do DataGridViewRowCollection.

Výjimky

ArgumentOutOfRangeException

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

ArgumentNullException

dataGridViewRow je null.

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

-nebo-

Vlastnost DataSource objektu DataGridView není null.

-nebo-

rowIndex se rovná počtu řádků v kolekci a AllowUserToAddRows vlastnost objektu je nastavená DataGridView na true.

-nebo-

Pole neobsahuje DataGridView žádné sloupce.

-nebo-

Vlastnost DataGridView není dataGridViewRownull.

-nebo-

dataGridViewRowSelected má hodnotu truevlastnosti .

-nebo-

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

ArgumentException

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

Poznámky

Metoda Insert(Int32, 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. 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é

Platí pro

Insert(Int32, Int32)

Vloží zadaný počet řádků do kolekce v zadaném umístění.

public:
 virtual void Insert(int rowIndex, int count);
public virtual void Insert (int rowIndex, int count);
abstract member Insert : int * int -> unit
override this.Insert : int * int -> unit
Public Overridable Sub Insert (rowIndex As Integer, count As Integer)

Parametry

rowIndex
Int32

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

count
Int32

Počet řádků, které se mají vložit do DataGridViewRowCollection.

Výjimky

ArgumentOutOfRangeException

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

-nebo-

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

Vlastnost DataSource objektu DataGridView není null.

-nebo-

Pole neobsahuje DataGridView žádné sloupce.

-nebo-

rowIndex se rovná počtu řádků v kolekci a AllowUserToAddRows vlastnost objektu je nastavená DataGridView na true.

-nebo-

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

-nebo-

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

Poznámky

Metoda Insert(Int32, Int32) 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í 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. 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é

Platí pro

Insert(Int32, Object[])

Vloží řádek do kolekce na zadanou pozici a naplní buňky zadanými objekty.

public:
 virtual void Insert(int rowIndex, ... cli::array <System::Object ^> ^ values);
public virtual void Insert (int rowIndex, params object[] values);
abstract member Insert : int * obj[] -> unit
override this.Insert : int * obj[] -> unit
Public Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())

Parametry

rowIndex
Int32

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

values
Object[]

Proměnlivý počet objektů, které naplní buňky nového řádku.

Výjimky

ArgumentOutOfRangeException

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

ArgumentNullException

values je null.

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

-nebo-

Vlastnost VirtualMode objektu je nastavená DataGridView na true.

-nebo-

Vlastnost DataSource objektu DataGridView není null.

-nebo-

Pole neobsahuje DataGridView žádné sloupce.

-nebo-

rowIndex se rovná počtu řádků v kolekci a AllowUserToAddRows vlastnost objektu je nastavená DataGridView na true.

-nebo-

Vlastnost DataGridView řádku vrácená vlastností ovládacího prvku RowTemplate není null.

-nebo-

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

ArgumentException

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

Poznámky

Metoda Insert(Int32, Object[]) přidá nesdílený řádek do objektu DataGridViewRowCollection.

Řá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é

Platí pro