RadioButtonList (control)

El control RadioButtonList representa un control de lista que encapsula un grupo de controles de botón de opción.

Puede usar dos tipos de controles ASP.NET para agregar botones de opción a una página: controles RadioButton individuales o un control RadioButtonList . Ambos controles permiten a los usuarios seleccionar opciones entre un pequeño conjunto de opciones predefinidas mutuamente excluyentes. Los controles permiten definir cualquier número de botones de opción con etiquetas y organizarlos de forma horizontal o vertical.

Para agregar un control RadioButtonList a una página

• Arrastre el control RadioButtonList del panel Cuadro de herramientas a la página.

Para enlazar el control RadioButtonList a un origen de datos

1. En la Vista de diseño, haga clic con el botón secundario en el control RadioButtonList y, a continuación, haga clic en Mostrar tareas de control comunes.

2. En el menú Tareas de RadioButtonList, haga clic en Elegir origen de datos.

3. En el Asistente para la configuración de orígenes de datos, elija un origen para el control RadioButtonList en el menú desplegable Seleccionar un origen de datos. En el menú desplegable Seleccionar un campo de datospara mostraren RadioButtonList, seleccione el campo del texto que verá el usuario. En el menú desplegable Seleccionar un campo de datos para el valor de RadioButtonList, seleccione el campo para los datos a los que se puede tener acceso mediante programación cuando el usuario elija un elemento en la lista.

Para definir elementos para el control RadioButtonList

1. En la Vista de diseño, haga clic con el botón secundario en el control RadioButtonList y, a continuación, haga clic en Mostrar tareas de control comunes.

2. En el menú Tareas de RadioButtonList, haga clic en Editar elementos.

3. En el cuadro de diálogo Editor de la colección ListItem, haga clic en Agregar para agregar un elemento.

4. En el área Propiedades de ListItem, establezca las propiedades Text y Value .

5. Repita los pasos 3 y 4 hasta que haya agregado todos los elementos que desee.

Para obtener una descripción completa de todas las propiedades del control RadioButtonList , vea el artículo RadioButtonList (Propiedades)  en MSDN Library.

Comparación de los controles RadioButton y RadioButtonList

Puede agregar controles RadioButton individuales a una página y usarlos por separado. Normalmente, agrupará dos o más botones individuales.

Por el contrario, el control RadioButtonList es un control único que actúa como control primario en una colección de elementos de lista de botones de opción.

Cada tipo de control tiene sus ventajas. Los controles RadioButton individuales ofrecen más control sobre el diseño del grupo de botones de opción. Por ejemplo, puede incluir texto (es decir, texto que no pertenezca a botones de opción) entre los botones de opción.

El control RadioButtonList no permite insertar texto entre los botones, pero es mucho más fácil de utilizar si se desea enlazar los botones a un origen de datos. También resulta algo más fácil escribir código que determine el botón que se ha seleccionado.

El control RadioButtonList desencadena un evento SelectedIndexChanged incluso cuando los usuarios cambian el botón de opción seleccionado en la lista. De forma predeterminada, este evento no envía el formulario al servidor, aunque se puede especificar esta opción estableciendo la propiedad AutoPostBack en true. Para obtener detalles, vea el artículo Cómo: Responder a la selección de un usuario en un grupo de controles RadioButton de servidor Web  en MSDN Library.

[!NOTA]

La capacidad de un control RadioButtonList de realizar envíos al servidor cuando se selecciona, requiere que el explorador sea compatible con ECMAScript (JScript, JavaScript) y que esté habilitado el uso de scripts en el explorador del usuario.

Copyright © 2011 de Microsoft Corporation. Reservados todos los derechos.