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

Referência

Definição

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.dll

Origem:: Collection.vb

Origem:: Collection.vb

Origem:: Collection.vb

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

ArgumentOutOfRangeException

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

NotSupportedException

O objeto Collection é somente leitura.

- ou -

O objeto Collection tem um tamanho fixo.

NullReferenceException

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

Partilhar via