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

Definição

Insere um item no Collection objeto 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 baseado em zero no qual value deve ser inserido.

value
Object

O Object para inserir no Collection objeto.

Exceções

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

O Collection objeto é só de leitura.

-ou-

O Collection objeto tem um tamanho fixo.

value é a referência nula no Collection objeto.

Observações

Se index for igual ao número de itens no Collection objeto, então value é acrescentado ao fim.

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

Aplica-se a

Ver também