DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) 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ží řádky do kolekce na zadané pozici.
public:
virtual void InsertCopies(int indexSource, int indexDestination, int count);
public virtual void InsertCopies (int indexSource, int indexDestination, int count);
abstract member InsertCopies : int * int * int -> unit
override this.InsertCopies : int * int * int -> unit
Public Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)
Parametry
- indexSource
- Int32
Index objektu DataGridViewRow , na kterém mají být nové řádky založeny.
- indexDestination
- Int32
Pozice, na kterou chcete řádky vložit.
- count
- Int32
Počet DataGridViewRow objektů, které mají být přidány do objektu DataGridViewRowCollection.
Výjimky
indexSource
je menší než nula nebo větší než počet řádků v kolekci minus jeden.
-nebo-
indexDestination
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-
indexDestination
se rovná počtu řádků v kolekci a AllowUserToAddRows je true
.
-nebo-
Tato operace vloží ukotvené řádky po rozmrazené řádky nebo řádky před ukotvené řádky.
Poznámky
Vlastnost InheritedStyle nových DataGridViewRow objektů má stejné hodnoty jako InheritedStyle vlastnost objektu umístěného DataGridViewRow v indexSource
. Metoda InsertCopies přidá sdílené řádky do objektu DataGridViewRowCollection, pokud je to možné. V opačném případě se nové řádky nesdílejí. 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.