Compartir a través de


Introducción al control SelectionList

Actualización: noviembre 2007

El control SelectionList muestra una lista de elementos y permite al usuario seleccionar uno o varios de estos elementos. Las aplicaciones pueden representar el control SelectionList en forma de cuadro de lista desplegable, cuadro de lista de selección, conjunto de casillas o conjunto de botones de opción. Un control SelectionList debe colocarse en un control Form o Panel, o dentro de la plantilla de un control de una página Web móvil. También puede arrastrarlo hasta una página de control de usuario móvil.

Lista de selección de ASP.NET

Este control, como no admite paginación, funciona mejor para las listas cortas. Para ver información más compleja de una base de datos con formato de tabla, utilice un control ObjectList.

Al seleccionar elementos en un control SelectionList, no se genera una respuesta inmediata del servidor de la aplicación. El formulario en el que aparece el control SelectionList debe devolverse al servidor. Esto se realiza normalmente con un control Command. Cuando el control Command devuelve el formulario al servidor, el control SelectionList provoca un evento SelectedIndexChanged que se puede controlar en el código del servidor. Otro modo de llevar a cabo esta operación consiste en agregar compatibilidad para los dispositivos que pueden controlar ECMAScript (JavaScript) de cliente, como los exploradores basados en HTML. Para obtener más información, vea SelectionList.

De forma predeterminada, las aplicaciones representan el control SelectionList en forma de lista desplegable. Este valor predeterminado puede modificarse mediante la propiedad SelectType. El valor de DropDown de la propiedad SelectType permite a los usuarios elegir un elemento de la lista. Para que los usuarios puedan seleccionar varios elementos, la propiedad SelectType debe establecerse en CheckBox o MultiSelectListBox.

Para definir los elementos de lista en tiempo de diseño, haga clic en el botón de puntos suspensivos (Elipse del Diseñador de ASP.NET Mobile) del cuadro de la propiedad Items del control, en la ventana Propiedades. Puede definir a continuación los elementos mediante el cuadro de diálogo Propiedades de SelectionList.

Si lo desea, la aplicación puede definir también los elementos en tiempo de ejecución. Esto último puede realizarse mediante programación o mediante el enlace de datos. La propiedad Items es de tipo MobileListItemCollection. Por tanto, las aplicaciones agregan elementos mediante programación utilizando el método Add de la clase MobileListItemCollection. Utilice las propiedades DataMember, DataSource, DataTextField y DataValueField del control SelectionList para agregar elementos mediante enlace de datos.

Puede personalizar la apariencia del control SelectionList utilizando los filtros de dispositivo, que permiten al control reemplazar de forma selectiva muchos valores de la propiedad.

Para obtener información sobre la validación de los datos escritos por el usuario en este control, vea Introducción a los controles de validación.

Vea también

Tareas

Cómo: Agregar y configurar un control SelectionList

Conceptos

Reemplazar propiedades

Introducción al control Form

Introducción al control Panel

Introducción al control ObjectList

Utilizar el enlace de datos con controles de ASP.NET Mobile

Referencia

SelectionList

Otros recursos

Utilizar filtros de dispositivo