Compartilhar via


Collection.IList.Insert(Int32, Object) Método

Definição

Insere um item no objeto Collection no índice especificado.

 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

Parâmetros

index
Int32

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

value
Object

O Object a ser inserido no objeto Collection.

Exceções

index não é um índice válido no objeto Collection.

O objeto Collection é somente leitura.

- ou -

O objeto Collection tem um tamanho fixo.

value é uma referência nula no objeto Collection.

Comentários

Se index for igual ao número de itens no Collection objeto, será value acrescentado ao final.

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.

Aplica-se a

Confira também