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

Definição

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

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

A Object inserção no Collection objeto.

Exceções

ArgumentOutOfRangeException

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

NotSupportedException

O Collection objeto é somente leitura.

-ou-

O Collection objeto tem um tamanho fixo.

NullReferenceException

value é referência nula no Collection objeto.

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 se movem para baixo para acomodar o novo elemento. Se a coleção for indexada, os índices dos elementos movidos também serão atualizados. Esse comportamento não se aplica a coleções em que os elementos são agrupados conceitualmente em buckets, como uma tabela de hash.

Aplica-se a

Confira também