Información general sobre ListBox (Control de servidor Web)

Artículo
10/22/2014

Actualización: noviembre 2007

El control de servidor Web ListBox permite a los usuarios seleccionar uno o varios elementos de una lista predefinida. Se diferencia de un control DropDownList en que puede mostrar varios elementos a la vez y, de manera opcional, permite al usuario seleccionar varios elementos.

Apariencia del control ListBox

El control ListBox se suele utilizar para mostrar más de un elemento a la vez. Puede controlar la apariencia de la lista de cualquiera de las siguientes maneras:

Número de filas mostradas. Puede definir el control para que muestre un número específico de elementos. Si el control contiene más elementos, muestra una barra de desplazamiento vertical.
Alto y ancho. Puede establecer el tamaño del control mediante píxeles. En este caso, el control omite el número de filas establecido y muestra tantas filas como quepan en el alto del control. Algunos exploradores no admiten que se establezca el alto y el ancho en píxeles, y utilizan la configuración de número de filas.

Como en el caso de otros controles de servidor Web, puede utilizar objetos de estilo para especificar la apariencia del control. Para obtener información detallada, vea Controles de servidor Web ASP.NET y estilos de CSS.

Elementos

El control ListBox es un contenedor para uno o varios elementos de lista. Cada elemento de lista es un objeto de tipo ListItem con propiedades específicas, que se describen en la tabla siguiente.

Propiedad	Descripción
Text	Texto que se muestra en la lista.
Value	Valor asociado a un elemento. Al establecer esta propiedad, puede asociar un valor a un elemento específico sin mostrarlo. Por ejemplo, puede establecer la propiedad Text en el nombre de un estado de EE.UU. y la propiedad Value, en su abreviatura postal.
Selected	Valor de tipo Boolean que indica si el elemento está seleccionado.

Para trabajar con elementos mediante programación, utilice la colección Items del control ListBox. La colección Items es una colección estándar, por lo que es posible agregar objetos de elementos, eliminar elementos, borrar la colección, etc.

El elemento que se encuentra seleccionado está disponible en la propiedad SelectedItem del control ListBox. Para facilitar su utilización, el control ListBox admite también una propiedad denominada SelectedItem. Si se configura el control en modo de selección simple, esta propiedad devuelve el único elemento seleccionado, lo que hace innecesario recorrer toda la colección Items para llegar a la selección actual.

Selección simple y selección múltiple

Normalmente, los usuarios pueden seleccionar un solo elemento de la lista, haciendo clic en él. Si se configura el control ListBox para que se puedan realizar varias selecciones, los usuarios deberán mantener presionada la tecla CTRL o MAYÚSCULAS mientras hacen clic en los elementos que deseen seleccionar.

Enlazar datos al control

Puede utilizar un control ListBox de servidor Web en las opciones de lista que aparecen en la página mediante un control de origen de datos. Cada elemento del control ListBox corresponde a un elemento, habitualmente una fila, del origen de datos.

El control muestra un campo del origen. Si lo desea, puede enlazar el control a un segundo campo para establecer el valor (que no se muestra) de un elemento.

Como ocurre con otros controles de servidor, puede enlazar a los datos cualquiera de las propiedades del control como, por ejemplo, el color o el tamaño. Para obtener información detallada, vea Cómo: Rellenar controles List de servidor Web desde un origen de datos.

Eventos de ListBox

El control ListBox provoca el evento SelectedIndexChanged cuando los usuarios seleccionan un elemento. De forma predeterminada, este evento no envía la página al servidor, aunque es posible forzar el envío de datos inmediato si se establece la propiedad AutoPostBack en true.

Nota:
La capacidad de un control ListBox de realizar envíos al servidor cuando se activa requiere que el explorador sea compatible con ECMAScript (JScript, JavaScript) y que esté habilitado el uso de secuencias de comandos en el explorador del usuario.