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

Definición

Espacio de nombres:

System.Collections.Specialized

Ensamblado:

System.Collections.Specialized.dll

Source:

StringCollection.cs

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

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

Insert(Int32, Object)

Excepciones

ArgumentOutOfRangeException

index es menor que cero.

O bien

index es mayor que Count.

NotSupportedException

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.

Consulte también

• Add(Object)
• Remove(Object)
• Count