Teilen über


StringCollection.IList.Insert(Int32, Object) Methode

Definition

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);
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

Ausnahmen

index ist kleiner als Null.

- oder -

index ist größer als Count.

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.

Gilt für:

Weitere Informationen