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

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.dll

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.

Confira também

• Collection
• IList
• Insert(Int32, Object)