Collection.IList.Insert(Int32, Object) Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.dll

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

ArgumentOutOfRangeException

index non è un indice valido nell'oggetto Collection.

NotSupportedException

L'oggetto Collection è in sola lettura.

-oppure-

L'oggetto Collection è di dimensioni fisse.

NullReferenceException

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.

Vedi anche

• Collection
• IList
• Insert(Int32, Object)