Collection.IList.Insert(Int32, Object) Methode

Definition

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.dll

Fügt dem Collection-Objekt am angegebenen Index ein Element hinzu.

 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

Parameter

index

Int32

Der nullbasierte Index, an dem value eingefügt werden soll.

value

Object

Das in das Object-Objekt einzufügende Collection.

Ausnahmen

ArgumentOutOfRangeException

index ist kein gültiger Index im Collection-Objekt.

NotSupportedException

Das Collection-Objekt ist schreibgeschützt.

- oder -

Das Collection-Objekt hat eine feste Größe.

NullReferenceException

value ist im Collection-Objekt ein NULL-Verweis.

Hinweise

Wenn index der Anzahl der Elemente im Collection -Objekt entspricht, value wird am Ende angefügt.

In Auflistungen mit zusammenhängenden Elementen, beispielsweise Listen, werden die Elemente hinter der Einfügemarke nach unten verschoben, um das neue Element aufzunehmen. Wenn die Auflistung indiziert ist, werden auch die Indizes der verschobenen Elemente aktualisiert. Dies gilt nicht für Auflistungen, in denen die Elemente konzeptionell in Buckets gruppiert sind, beispielsweise Hashtabellen.

Weitere Informationen

• Collection
• IList
• Insert(Int32, Object)