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

Definición

Inserta un elemento en StringCollection en el índice especificado.Inserts an element into the StringCollection at the specified index.

 virtual void System.Collections.IList.Insert(int index, System::Object ^ value) = System::Collections::IList::Insert;
void IList.Insert (int index, object value);
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.The zero-based index at which value should be inserted.

value
Object

Object que se va a insertar.The Object to insert. El valor puede ser null.The value can be null.

Implementaciones

Excepciones

index es menor que cero.index is less than zero.

o bien-or- index es mayor que Count.index is greater than Count.

StringCollection es de solo lectura.The StringCollection is read-only.

o bien-or- StringCollection tiene un tamaño fijo.The StringCollection has a fixed size.

Comentarios

Si Count ya es igual a la capacidad, la capacidad StringCollection de aumenta reasignando automáticamente la matriz interna y los elementos existentes se copian en la nueva matriz antes de agregar el nuevo elemento.If Count already equals the capacity, the capacity of the StringCollection is increased by automatically reallocating the internal array, and the existing elements are copied to the new array before the new element is added.

Si index es igual a Count, value se agrega al final de StringCollection.If index is equal to Count, value is added to the end of 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.In collections of contiguous elements, such as lists, the elements that follow the insertion point move down to accommodate the new element. Si la colección está indizada, también se actualizan los índices de los elementos que se han movido.If the collection is indexed, the indexes of the elements that are moved are also updated. Este comportamiento no se aplica a las colecciones cuyos elementos se agrupan conceptualmente en sectores de almacenamiento, como una tabla hash.This behavior does not apply to collections where elements are conceptually grouped into buckets, such as a hash table.

Este método es una operación On(), donde n es Count.This method is an O(n) operation, where n is Count.

Se aplica a

Consulte también: