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

Definição

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

value
Object

O Object para inserir. O valor pode ser null.

Implementações

Exceções

index é inferior a zero.

-ou-

index é maior que Count.

É StringCollection só de leitura.

-ou-

Tem StringCollection um tamanho fixo.

Observações

Se Count já for igual à capacidade, a capacidade de é StringCollection aumentada ao realocar automaticamente o array interno, e os elementos existentes são copiados para o novo array antes de o novo elemento ser adicionado.

Se index for igual a Count, value é somado 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. Se a coleção for indexada, os índices dos elementos movidos também são atualizados. Este comportamento não se aplica a coleções onde os elementos são conceptualmente agrupados em baldes, como uma tabela de hash.

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

Aplica-se a

Ver também