Collection.IList.Insert(Int32, Object) Metodo

Definizione

Inserisce un elemento nell'oggetto Collection in corrispondenza dell'indice specificato.

 virtual void IListInsert(int index, System::Object ^ value) = System::Collections::IList::Insert;
void IList.Insert (int index, object value);
abstract member IListInsert : int * obj -> unit
override this.IListInsert : int * obj -> unit
Sub IListInsert (index As Integer, value As Object) Implements IList.Insert

Parametri

index
Int32

Indice in base zero nel quale value deve essere inserito.

value
Object

Object da inserire nell'oggetto Collection.

Eccezioni

index non è un indice valido nell'oggetto Collection.

L'oggetto Collection è in sola lettura.

-oppure-

L'oggetto Collection è di dimensioni fisse.

value è un riferimento null nell'oggetto Collection.

Commenti

Se index è uguale al numero di elementi nell'oggetto Collection , value viene aggiunto alla fine.

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.

Si applica a

Vedi anche