Collection.IList.Insert(Int32, Object) Metodo

Definizione

Inserisce un elemento nell'oggetto Collection in corrispondenza dell'indice specificato.Inserts an item to the Collection object at the specified index.

 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.The zero-based index at which value should be inserted.

value
Object

Object da inserire nell'oggetto Collection.The Object to insert into the Collection object.

Eccezioni

index non è un indice valido nell'oggetto Collection.index is not a valid index in the Collection object.

L'oggetto Collection è in sola lettura.The Collection object is read-only.

-oppure--or- L'oggetto Collection è di dimensioni fisse.The Collection object has a fixed size.

value è un riferimento null nell'oggetto Collection.value is null reference in the Collection object.

Commenti

Se index è uguale al numero di elementi nell' Collection oggetto, value viene accodato alla fine.If index equals the number of items in the Collection object, then value is appended to the end.

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.In collections of contiguous elements, such as lists, the elements that follow the insertion point move down to accommodate the new element. Se la raccolta è indicizzata, vengono aggiornati anche gli indici degli elementi spostati.If the collection is indexed, the indexes of the elements that are moved are also updated. Questo comportamento non viene applicato alle raccolte in cui gli elementi sono raggruppati concettualmente in bucket, come accade ad esempio per le tabelle hash.This behavior does not apply to collections where elements are conceptually grouped into buckets, such as a hash table.

Si applica a

Vedi anche