Udostępnij za pośrednictwem


StringCollection.IList.Insert(Int32, Object) Metoda

Definicja

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);
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

Wyjątki

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

-lub-

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

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.

Dotyczy

Zobacz też