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ží 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 -> unitPublic 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
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ě 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-
dataGridViewRow
Selected má hodnotu truevlastnosti .
-nebo-
Tato operace by vložila ukotvený řádek po rozbalené řádky nebo řádek před ukotvené řádky.
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 -> unitPublic 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
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ě 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[] -> unitPublic 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
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ě 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.
Řá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.
