Freigeben über


Collection.IList.Insert(Int32, Object) Methode

Definition

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

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

Das Collection-Objekt ist schreibgeschützt.

- oder -

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

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:

Weitere Informationen