DataGridViewRowCollection.InsertCopy(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ží řádek do kolekce na zadanou pozici na základě řádku na zadané pozici.
public:
virtual void InsertCopy(int indexSource, int indexDestination);
public virtual void InsertCopy (int indexSource, int indexDestination);
abstract member InsertCopy : int * int -> unit
override this.InsertCopy : int * int -> unit
Public Overridable Sub InsertCopy (indexSource As Integer, indexDestination As Integer)
Parametry
- indexSource
- Int32
Index řádku, na kterém má být nový řádek založen.
- indexDestination
- Int32
Pozice, na kterou chcete řádek vložit.
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.
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 by vložila ukotvený řádek po rozbalené řádky nebo řádek před ukotvené řádky.
Poznámky
Tato metoda přiřadí novému řádku index zadaný v parametru indexDestination
a zvýší indexy pro všechny následující řádky. Vlastnost InheritedStyle nového DataGridViewRow má stejné hodnoty jako InheritedStyle vlastnost umístěná DataGridViewRow na indexSource
. Metoda InsertCopy 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.