StringCollection.IList.Insert(Int32, Object) Metodo

Definizione

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

Eccezioni

index è minore di zero.

-oppure-

index è maggiore di Count.

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.

Si applica a

Vedi anche