ListBox.ObjectCollection.Insert(Int32, Object) Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Inserta un elemento en el cuadro de lista en el índice especificado.

public:
 virtual void Insert(int index, System::Object ^ item);

public:
 void Insert(int index, System::Object ^ item);

public void Insert (int index, object item);

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

member this.Insert : int * obj -> unit

Public Sub Insert (index As Integer, item As Object)

Parámetros

index

Int32

Ubicación del índice de base cero donde se inserta el elemento.

item

Object

Objeto que representa el elemento que se va a insertar.

Implementaciones

Insert(Int32, Object)

Excepciones

ArgumentOutOfRangeException

El parámetro index es menor que cero o mayor que el valor de la propiedad Count de la clase ListBox.ObjectCollection.

ArgumentNullException

item es null.

Comentarios

Este método permite insertar un elemento en una posición específica dentro de ListBox. Si la Sorted propiedad de ListBox se establece en true, el elemento se agrega en la posición correcta dentro de la lista ordenada, independientemente de los valores especificados en el index parámetro . Cuando se agrega un objeto a la colección, la ListBox primera comprueba si la DisplayMember propiedad de la ListControl clase tiene el nombre de un miembro del objeto especificado para hacer referencia al obtener el texto del elemento. Si la DisplayMember propiedad no tiene un miembro especificado, ListBox llama al ToString método del objeto para obtener el texto que se va a mostrar en la lista.