StringCollection.IList.Insert(Int32, Object) Metod

Definition

Namnområde:
System.Collections.Specialized
Sammansättningar:
System.dll, System.Collections.Specialized.dll
Sammansättning:
System.dll
Sammansättning:
netstandard.dll

Infogar ett element i StringCollection det angivna indexet.

 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

Parametrar

index
Int32

Det nollbaserade index som value ska infogas i.

value
Object

Infoga Object . Värdet kan vara null.

Implementeringar

Insert(Int32, Object)

Undantag

ArgumentOutOfRangeException

index är mindre än noll.

-eller-

index är större än Count.

NotSupportedException

Är StringCollection skrivskyddad.

-eller-

Har StringCollection en fast storlek.

Kommentarer

Om Count det redan är lika med kapaciteten ökar kapaciteten för den StringCollection genom att automatiskt omplacera den interna matrisen och de befintliga elementen kopieras till den nya matrisen innan det nya elementet läggs till.

Om index är lika med Countvalue läggs till i slutet av StringCollection.

I samlingar med sammanhängande element, till exempel listor, flyttas elementen som följer insättningspunkten nedåt för att anpassa det nya elementet. Om samlingen indexeras uppdateras även indexen för de element som flyttas. Det här beteendet gäller inte för samlingar där element grupperas konceptuellt i bucketar, till exempel en hash-tabell.

Den här metoden är en O()-nåtgärd, där n är Count.

Gäller för

Se även