StringCollection.IList.Insert(Int32, Object) Methode

Definition

Namespace:
System.Collections.Specialized
Assemblys:
System.dll, System.Collections.Specialized.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Fügt ein Element in den StringCollection angegebenen Index 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 Text Object . Der Wert kann sein null.

Implementiert

Insert(Int32, Object)

Ausnahmen

ArgumentOutOfRangeException

index ist kleiner als 0 (null).

-oder-

index ist größer als Count.

NotSupportedException

Dies StringCollection ist schreibgeschützt.

-oder-

Die StringCollection Größe hat eine feste Größe.

Hinweise

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

Ist index gleich Count, value wird am Ende von StringCollection.

In Auflistungen zusammenhängender Elemente, z. B. Listen, werden die Elemente, die der Einfügemarke folgen, nach unten verschoben, um das neue Element aufzunehmen. Wenn die Auflistung indiziert ist, werden auch die Indizes der verschobenen Elemente aktualisiert. Dieses Verhalten gilt nicht für Sammlungen, bei denen Elemente konzeptionell in Buckets gruppiert sind, z. B. eine Hashtabelle.

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

Gilt für:

Weitere Informationen