StringCollection.IList.Insert(Int32, Object) Methode

Definition

Namespace:

System.Collections.Specialized

Assembly:

System.Collections.Specialized.dll

Quelle:

StringCollection.cs

Fügt am angegebenen Index ein Element in die StringCollection ein.

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

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

abstract member System.Collections.IList.Insert : int * obj -> unit
override this.System.Collections.IList.Insert : int * obj -> unit

Sub Insert (index As Integer, value As Object) Implements IList.Insert

Parameter

index

Int32

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

value

Object

Der einzufügende Object. Der Wert kann null sein.

Implementiert

Insert(Int32, Object)

Ausnahmen

ArgumentOutOfRangeException

index ist kleiner als Null.

- oder -

index ist größer als Count.

NotSupportedException

StringCollection ist schreibgeschützt.

- oder -

StringCollection hat eine feste Größe.

Hinweise

Wenn Count bereits der Kapazität entspricht, wird die Kapazität von StringCollection erhöht, indem das interne Array automatisch neu zugeordnet wird, und die vorhandenen Elemente werden in das neue Array kopiert, bevor das neue Element hinzugefügt wird.

Wenn index gleich ist, Countvalue wird am Ende von StringCollectionhinzugefü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.

Bei dieser Methode handelt es sich um einen O(n)-Vorgang, wobei n ist Count.

Weitere Informationen

• Add(Object)
• Remove(Object)
• Count