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

Definição

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

value
Object

A Object inserção a ser inserida. O valor pode ser null.

Implementações

Exceções

index é menor que zero.

-ou-

index é maior que Count.

O StringCollection é somente leitura.

-ou-

O StringCollection tem um tamanho fixo.

Comentários

Se Count já for igual à capacidade, a capacidade do valor será aumentada realocando automaticamente a matriz interna e os elementos existentes serão copiados para a nova matriz antes que StringCollection 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 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.

Esse método é uma operação O(n), onde n está Count.

Aplica-se a

Confira também