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

Definição

Insere um elemento no StringCollection, no índice especificado.

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

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

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 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.

Aplica-se a

Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

Confira também