Collection.IList.Insert(Int32, Object) Methode

Referenz

Definition

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.dll

Quelle:: Collection.vb

Quelle:: Collection.vb

Quelle:: Collection.vb

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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.

Gilt für:

Freigeben über