DataGridViewRowCollection.IList.Insert(Int32, Object) Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

DataGridViewRow Vloží objekt do kolekce v zadaném indexu.

 virtual void System.Collections.IList.Insert(int index, System::Object ^ value) = System::Collections::IList::Insert;

void IList.Insert (int index, object value);

abstract member System.Collections.IList.Insert : int * obj -> unit
override this.System.Collections.IList.Insert : int * obj -> unit

Sub Insert (index As Integer, value As Object) Implements IList.Insert

Parametry

index

Int32

Index založený na nule, do kterého se má položka value vložit

value

Object

Vloží DataGridViewRow se do .DataGridViewRowCollection

Implementuje

Insert(Int32, Object)

Výjimky

InvalidCastException

valuenení .DataGridViewRow

ArgumentOutOfRangeException

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

ArgumentNullException

value je null.

InvalidOperationException

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

• Vymaže se výběr.

-nebo-

Tato metoda se volá z obslužné rutiny pro jednu z následujících DataGridView událostí:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-nebo-

Vlastnost DataSourceDataGridView není null.

-nebo-

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

-nebo-

Pole DataGridView neobsahuje žádné sloupce.

-nebo-

Vlastnost DataGridViewvalue není null.

-nebo-

valueSelected má hodnotu truevlastnosti .

-nebo-

Tato operace by vložila ukotvený řádek po zrušení zmrazování řádků nebo řádek bez zmrazování před ukotvené řádky.

ArgumentException

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

Poznámky

Tento člen je explicitní implementace členu rozhraní. Lze jej použít pouze v DataGridViewRowCollection případě, že je instance přetypovaná na IList rozhraní.

Tato metoda volá Insert(Int32, DataGridViewRow) přetížení a předává hodnotu po přetypování do DataGridViewRow.

Řádky v ovládacím prvku nejsou při přidání nových řádků automaticky seřazeny. Pokud chcete 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 k seřazení řádků, když uživatel upraví buňku.

Viz také

• DataGridView
• DataGridViewRow
• IList