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 in corrispondenza del quale value deve essere inserito.

value
Object

Oggetto Object da inserire nell'oggetto Collection .

Eccezioni

index non è un indice valido nell'oggetto Collection .

L'oggetto Collection è di sola lettura.

oppure

L'oggetto Collection ha una dimensione fissa.

value è un riferimento Null nell'oggetto Collection .

Commenti

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

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.

Si applica a

Vedi anche