Collection.IList.Insert(Int32, Object) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.VisualBasic

Zestaw:: Microsoft.VisualBasic.dll

Źródło:: Collection.vb

Źródło:: Collection.vb

Źródło:: Collection.vb

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wstawia element do Collection obiektu w określonym indeksie.

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

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

abstract member IListInsert : int * obj -> unit
override this.IListInsert : int * obj -> unit

Sub IListInsert (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

Element Object do wstawienia do Collection obiektu.

Wyjątki

ArgumentOutOfRangeException

index nie jest prawidłowym indeksem Collection w obiekcie.

NotSupportedException

Obiekt Collection jest tylko do odczytu.

-lub-

Obiekt Collection ma stały rozmiar.

NullReferenceException

value jest odwołaniem o wartości null w Collection obiekcie.

Uwagi

Jeśli index jest równa liczbie elementów w Collection obiekcie, zostanie value dołączona na końcu.

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.

Dotyczy

Udostępnij za pośrednictwem