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

Definição

Namespace:

System.Collections.Specialized

Assembly:

System.Collections.Specialized.dll

Origem:

StringCollection.cs

Insere um elemento no StringCollection, no índice especificado.

 virtual void System.Collections.IList.Insert(int index, System::Object ^ value) = System::Collections::IList::Insert;

void IList.Insert (int index, object? value);

abstract member System.Collections.IList.Insert : int * obj -> unit
override this.System.Collections.IList.Insert : int * obj -> unit

Sub Insert (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. O valor pode ser null.

Implementações

Insert(Int32, Object)

Exceções

ArgumentOutOfRangeException

index é menor que zero.

- ou -

index é maior que Count.

NotSupportedException

O StringCollection é somente leitura.

- ou -

O StringCollection tem um tamanho fixo.

Comentários

Se Count já for igual à capacidade, a capacidade do StringCollection será aumentada realocando automaticamente a matriz interna e os elementos existentes serão copiados para a nova matriz antes que o novo elemento seja adicionado.

Se index for igual a Count, value será adicionado ao final de StringCollection.

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.

Este método é uma operação O(n), em que n é Count.

Confira também

• Add(Object)
• Remove(Object)
• Count