StringCollection.IList.Insert(Int32, Object) Metodo

Definizione

Inserisce un elemento nell'oggetto 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 in corrispondenza del 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.

è StringCollection di sola lettura.

oppure

Ha StringCollection una dimensione fissa.

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.

Negli insiemi di elementi contigui, ad esempio elenchi, gli elementi che seguono il punto di inserimento si spostano verso il basso per contenere il nuovo elemento. Se la raccolta viene indicizzata, vengono aggiornati anche gli indici degli elementi spostati. Questo comportamento non si applica alle raccolte in cui gli elementi vengono raggruppati concettualmente in bucket, ad esempio una tabella hash.

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

Si applica a

Vedi anche