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

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

Zobacz też