Partilhar via


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

Definição

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);
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

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

Confira também