StringCollection.IList.Insert(Int32, Object) Metoda

Definice

Obor názvů:

System.Collections.Specialized

Sestavení:

System.Collections.Specialized.dll

Zdroj:

StringCollection.cs

Vloží prvek do zadaného indexu StringCollection .

 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

Instance Object, která má být vložena. Hodnota může být null.

Implementuje

Insert(Int32, Object)

Výjimky

ArgumentOutOfRangeException

Hodnota index je menší než nula.

-nebo-

index je větší než Count.

NotSupportedException

Je StringCollection jen pro čtení.

-nebo-

Má StringCollection pevnou velikost.

Poznámky

Pokud Count se již rovná kapacitě, kapacita objektu StringCollection se zvýší automatickým opětovným přidělením interního pole a existující prvky se zkopírují do nového pole před přidáním nového prvku.

Pokud index se hodnota rovná hodnotě Count, value přidá se na konec .StringCollection

V kolekcích souvislých prvků, například seznamů, se prvky následující po bodu vložení při vložení nového prvku posouvají dolů. Je-li kolekce indexována, budou aktualizovány rovněž indexy přesunutých prvků. Toto chování se nevztahuje na kolekce, kde prvky jsou koncepčně seskupeny do sad, tj. například na tabulky hash.

Tato metoda je operace O(n), kde n je Count.

Viz také

• Add(Object)
• Remove(Object)
• Count