StringCollection.IList.Insert(Int32, Object) Metodo

Definizione

Spazio dei nomi:

System.Collections.Specialized

Assembly:

System.Collections.Specialized.dll

Origine:

StringCollection.cs

Inserisce un elemento in StringCollection in corrispondenza dell'indice specificato.

 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

Parametri

index

Int32

Indice in base zero nel quale value deve essere inserito.

value

Object

Oggetto Object da inserire. Il valore può essere null.

Implementazioni

Insert(Int32, Object)

Eccezioni

ArgumentOutOfRangeException

index è minore di zero.

-oppure-

index è maggiore di Count.

NotSupportedException

La classe StringCollection è di sola lettura.

-oppure-

Le dimensioni dell'oggetto StringCollection sono fisse.

Commenti

Se Count è già uguale alla capacità, la capacità di viene aumentata riallocazione automatica della StringCollection matrice interna e gli elementi esistenti vengono copiati nella nuova matrice prima dell'aggiunta del nuovo elemento.

Se index è uguale a Count, value viene aggiunto alla fine di StringCollection.

In raccolte di elementi adiacenti, quali gli elenchi, gli elementi successivi al punto di inserimento vengono spostati verso il basso per consentire l'inserimento del nuovo elemento. Se la raccolta è indicizzata, vengono aggiornati anche gli indici degli elementi spostati. Questo comportamento non viene applicato alle raccolte in cui gli elementi sono raggruppati concettualmente in bucket, come accade ad esempio per le tabelle hash.

Questo metodo è un'operazione O(n), dove n è Count.

Vedi anche

• Add(Object)
• Remove(Object)
• Count