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

Definición

Espacio de nombres:

Microsoft.VisualBasic

Ensamblado:

Microsoft.VisualBasic.dll

Inserta un elemento en el índice especificado del objeto Collection.

 virtual void IListInsert(int index, System::Object ^ value) = System::Collections::IList::Insert;

void IList.Insert (int index, object value);

abstract member IListInsert : int * obj -> unit
override this.IListInsert : int * obj -> unit

Sub IListInsert (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

Objeto Object que va a insertarse en el objeto Collection.

Excepciones

ArgumentOutOfRangeException

index no es un índice válido para el objeto Collection.

NotSupportedException

El objeto Collection es de solo lectura.

o bien

El objeto Collection tiene un tamaño fijo.

NullReferenceException

value es una referencia nula del objeto Collection.

Comentarios

Si index es igual al número de elementos del Collection objeto , value se anexa al final.

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.

Consulte también

• Collection
• IList
• Insert(Int32, Object)