StringCollection.IList.Insert(Int32, Object) Methode

Referenz

Definition

Namespace:: System.Collections.Specialized

Assemblys:: System.dll, System.Collections.Specialized.dll

Assembly:: System.Collections.Specialized.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Quelle:: StringCollection.cs

Quelle:: StringCollection.cs

Quelle:: StringCollection.cs

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

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.

Gilt für:

Freigeben über