DataGridViewRowCollection.Insert Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vloží do kolekce jeden nebo více řádků.
Přetížení
| Name | Description |
|---|---|
| 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 zadané 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 -> unitPublic Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)Parametry
- rowIndex
- Int32
Pozice, do které chcete vložit řádek.
- dataGridViewRow
- DataGridViewRow
Vložte DataGridViewRow ho do .DataGridViewRowCollection
Výjimky
rowIndex je menší než nula nebo větší než počet řádků v kolekci.
dataGridViewRow je null.
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í:
nebo
Vlastnost DataSourceDataGridView není null.
nebo
rowIndex je roven počtu řádků v kolekci a AllowUserToAddRows vlastnost DataGridView je nastavena na true.
nebo
Neobsahuje DataGridView žádné sloupce.
nebo
Vlastnost DataGridViewdataGridViewRow není null.
nebo
dataGridViewRow
Selected má hodnotu truevlastnosti .
nebo
Tato operace vloží ukotvený řádek za řádky bez zamrzlé řádky nebo řádek bez zamrzlého řádku.
dataGridViewRow obsahuje více buněk, než jsou v ovládacím prvku sloupce.
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 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é
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 -> unitPublic Overridable Sub Insert (rowIndex As Integer, count As Integer)Parametry
- rowIndex
- Int32
Pozice, do které chcete vložit řádky.
- count
- Int32
Počet řádků, které se mají vložit do DataGridViewRowCollection.
Výjimky
rowIndex je menší než nula nebo větší než počet řádků v kolekci.
nebo
count je menší než 1.
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í:
nebo
Vlastnost DataSourceDataGridView není null.
nebo
Neobsahuje DataGridView žádné sloupce.
nebo
rowIndex je roven počtu řádků v kolekci a AllowUserToAddRows vlastnost DataGridView je nastavena na true.
nebo
Řádek vrácený RowTemplate vlastností má více buněk, než jsou sloupce v ovládacím prvku.
nebo
Tato operace vloží ukotvený řádek za řádky bez zamrzlé řádky nebo řádek bez zamrzlého řádku.
Poznámky
Metoda Insert(Int32, Int32) přidá řádky, které jsou založeny na RowTemplate .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é
Platí pro
Insert(Int32, Object[])
Vloží řádek do kolekce na zadané 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[] -> unitPublic Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())Parametry
- rowIndex
- Int32
Pozice, do které chcete vložit řádek.
- values
- Object[]
Proměnný počet objektů, které naplňují buňky nového řádku.
Výjimky
rowIndex je menší než nula nebo větší než počet řádků v kolekci.
values je null.
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í:
nebo
Vlastnost VirtualMode objektu DataGridView je nastavena na hodnotu true.
nebo
Vlastnost DataSourceDataGridView není null.
nebo
Neobsahuje DataGridView žádné sloupce.
nebo
rowIndex je roven počtu řádků v kolekci a AllowUserToAddRows vlastnost DataGridView je nastavena na true.
nebo
DataGridView Vlastnost řádku vráceného vlastností ovládacího prvku RowTemplate není null.
nebo
Tato operace vloží ukotvený řádek za řádky bez zamrzlé řádky nebo řádek bez zamrzlého řádku.
Řádek vrácený vlastností ovládacího prvku RowTemplate má více buněk, než jsou sloupce v ovládacím prvku.
Poznámky
Metoda Insert(Int32, Object[]) přidá nesdílený řádek do DataGridViewRowCollection.
Řá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.
