StringCollection.IList.Insert(Int32, Object) Methode

Definitie

Naamruimte:
System.Collections.Specialized
Assembly's:
System.dll, System.Collections.Specialized.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Hiermee voegt u een element in de StringCollection opgegeven index in.

 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

Parameters

index
Int32

De op nul gebaseerde index waarop value moet worden ingevoegd.

value
Object

De Object te invoegen. De waarde kan zijn null.

Implementeringen

Insert(Int32, Object)

Uitzonderingen

ArgumentOutOfRangeException

index is kleiner dan nul.

– of –

index is groter dan Count.

NotSupportedException

Het StringCollection is alleen-lezen.

– of –

De StringCollection heeft een vaste grootte.

Opmerkingen

Als Count de capaciteit al gelijk is aan de capaciteit, wordt de capaciteit StringCollection verhoogd door de interne matrix automatisch opnieuw te verplaatsen en worden de bestaande elementen gekopieerd naar de nieuwe matrix voordat het nieuwe element wordt toegevoegd.

Als index dit gelijk is aan Count, value wordt toegevoegd aan het einde van StringCollection.

In verzamelingen van aaneengesloten elementen, zoals lijsten, gaan de elementen die volgen op de invoegpositie omlaag om het nieuwe element weer te geven. Als de verzameling is geïndexeerd, worden de indexen van de verplaatste elementen ook bijgewerkt. Dit gedrag is niet van toepassing op verzamelingen waarin elementen conceptueel zijn gegroepeerd in buckets, zoals een hash-tabel.

Deze methode is een O(n)-bewerking, waarbij n .Count

Van toepassing op

Zie ook