Compartir a través de


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

Definición

Inserta un elemento en StringCollection en el í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

Índice basado en cero en el que debe insertarse value.

value
Object

Object que se va a insertar. El valor puede ser null.

Implementaciones

Excepciones

index es menor que cero.

O bien

index es mayor que Count.

StringCollection es de solo lectura.

o bien

StringCollection tiene un tamaño fijo.

Comentarios

Si Count ya es igual a la capacidad, la capacidad de se incrementa mediante la reasignación automática de StringCollection la matriz interna y los elementos existentes se copian en la nueva matriz antes de agregar el nuevo elemento.

Si index es igual a Count, value se agrega al final de StringCollection.

En colecciones de elementos contiguos, como listas, los elementos que van a continuación del punto de inserción se desplazan hacia abajo para alojar el elemento nuevo. Si la colección está indizada, también se actualizan los índices de los elementos que se han movido. Este comportamiento no se aplica a las colecciones cuyos elementos se agrupan conceptualmente en sectores de almacenamiento, como una tabla hash.

Este método es una operación O(n), donde n es Count.

Se aplica a

Consulte también