IList<T>.Insert(Int32, T) Método

Definição

Namespace:

System.Collections.Generic

Assembly:

System.Runtime.dll

Insere um item na IList<T> no índice especificado.

public:
 void Insert(int index, T item);

public void Insert (int index, T item);

abstract member Insert : int * 'T -> unit

Public Sub Insert (index As Integer, item As T)

Parâmetros

index

Int32

O índice de base zero no qual o item deve ser inserido.

item

T

O objeto a ser inserido no IList<T>.

Exceções

ArgumentOutOfRangeException

index não é um índice válido no IList<T>.

NotSupportedException

O IList<T> é somente leitura.

Comentários

Se index for igual ao número de itens no IList<T>, será item acrescentado à lista.

Em coleções de elementos contíguos, como listas, os elementos que seguem o ponto de inserção descem para acomodar o novo elemento. Caso a coleção seja indexada, os índices dos elementos que são movidos também são atualizados. Este comportamento não se aplica às coleções em que elementos sejam agrupados conceitualmente em buckets, como uma tabela de hash.

Confira também

• IsReadOnly