StringCollection.IList.Insert(Int32, Object) Metoda

Definicja

Przestrzeń nazw:

System.Collections.Specialized

Zestaw:

System.Collections.Specialized.dll

Źródło:

StringCollection.cs

Wstawia element do StringCollection określonego indeksu.

 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

Liczony od elementu zerowego indeks, w którym powinien zostać wstawiony parametr value.

value

Object

Obiekt Object do wstawienia. Wartość może być null.

Implementuje

Insert(Int32, Object)

Wyjątki

ArgumentOutOfRangeException

Parametr index ma wartość niższą niż zero.

-lub-

index wartość jest większa niż Count.

NotSupportedException

Element StringCollection jest tylko do odczytu.

-lub-

Element StringCollection ma stały rozmiar.

Uwagi

Jeśli Count pojemność jest już równa pojemności, zwiększa StringCollection się przez automatyczne przydzielenie tablicy wewnętrznej, a istniejące elementy są kopiowane do nowej tablicy przed dodaniu nowego elementu.

Jeśli index wartość jest równa Count, value zostanie dodana na końcu elementu StringCollection.

W kolekcjach elementów sąsiadujących, takich jak listy, elementy umieszczone po punkcie wstawienia przesuwają się w dół, aby zwolnić miejsce na nowy element. Jeśli kolekcja jest indeksowana, indeksy przeniesionych elementów również są aktualizowane. To zachowanie nie dotyczy kolekcji, w których elementy są pod względem koncepcyjnym pogrupowane w przedziały, np. tablic skrótów.

Ta metoda jest operacją O(n), gdzie n to Count.

Zobacz też

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