BulletedList (control)

El control BulletedList crea una lista de elementos no ordenados u ordenados (numerados) que se representa como una etiqueta HTML UL u OL, respectivamente. Puede especificar el aspecto de los elementos y de las viñetas o los números, definir los elementos de lista estáticamente o enlazando el control a datos, y puede responder a los clics de los usuarios en los elementos.

Para agregar un control BulletedList a una página

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

Para enlazar el control BulletedList a un origen de datos

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

   Sugerencia:
   También puede hacer clic en el control BulletedList en la Vista de diseño y hacer clic en la flecha de la esquina superior derecha para que aparezca el menú Tareas de BulletedList. Haga clic de nuevo en la flecha para ocultar el menú.

2. En el menú Tareas de BulletedList, 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 BulletedList en la lista desplegable Seleccionar un origen de datos. En el menú desplegable Seleccionar un campo de datos para mostrar en BulletedList, seleccione el campo del texto que verá el usuario. En el menú desplegable Seleccionar un campo de datos para el valor de BulletedList, 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.

Definir elementos de lista

Puede definir elementos de lista para el control BulletedList creando elementos estáticos o enlazando el control a un origen de datos. Puede combinar elementos de lista estáticos y elementos de lista enlazados a datos; para ello, establezca la propiedad AppendDataBoundItems del control en True.

Al definir los elementos para el control BulletedList , se definen dos propiedades: Text y Value . La propiedad Text define lo que el control muestra en la página. La propiedad Value define un segundo valor que no se muestra pero que quizás desee devolver cuando un usuario seleccione un elemento. Por ejemplo, podría mostrar el nombre de un empleado como texto de un elemento, pero utilizar el Id. del empleado como valor; cuando los usuarios hagan clic en el elemento, podrá leer el valor directamente.

Para definir elementos para el control BulletedList

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

2. En el menú Tareas de BulletedList, 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.

   [!NOTA]

   No utilice datos confidenciales, como números de cliente, en la propiedad Value de un control BulletedList . Aunque no pueda verse, la configuración de la propiedad Value de los elementos individuales se representa en la página, y los usuarios podrán verla con facilidad en el código fuente de la misma.

Personalizar la apariencia de elementos de lista

Puede especificar más opciones de presentación para el control BulletedList en el panel Propiedades de etiqueta.

Para usar el panel Propiedades de etiqueta y establecer las propiedades BulletedList

1. En la Vista de diseño, haga clic con el botón secundario en el control BulletedList y haga clic en Propiedades en el menú contextual.

2. Escriba los valores de las propiedades o selecciónelos en las listas desplegables, cuando estén disponibles.

El control BulletedList puede representar viñetas o números, dependiendo de la configuración de la propiedad BulletStyle . Si el control se establece para que represente viñetas, puede seleccionar campos de estilo de viñeta predefinidos que coincidan con los estilos de viñeta estándar de HTML, como los que representan los campos Disc, Circle y Square.

[!NOTA]

Los exploradores no representan de igual forma las viñetas, y algunos exploradores no admiten ciertos estilos de viñeta, como el campo Disc .

También puede especificar una imagen personalizada que se mostrará en lugar de la viñeta.

Si el control se establece para que represente números, puede seleccionar también las opciones de numeración estándar de HTML, como los campos LowerAlpha , LowerRoman y UpperAlpha . También puede definir la propiedad FirstBulletNumber para especificar un número inicial de la secuencia.

Especificar el modo de presentación de un elemento

El control BulletedList puede mostrar elementos de lista de las siguientes formas:

• Texto estático    El texto mostrado por el control no es interactivo.

• ControlesHyperLink    Los usuarios pueden hacer clic en los vínculos para desplazarse a otra página. Debe proporcionar una dirección URL de destino como la propiedad Valor de los elementos individuales.

• ControlesLinkButton    Los usuarios pueden hacer clic en los elementos individuales y el control realiza una devolución de datos.

[!NOTA]

Si ha establecido la propiedad DisplayMode en HyperLink , especifique las direcciones URL de destino de los hipervínculos en la propiedad Value de cada elemento.

Defina la propiedad BulletStyle para especificar si el control muestra los elementos como viñetas o como números. Para crear una lista numerada u ordenada, establezca la propiedad BulletStyle en uno de los valores de enumeración siguientes:

• Numbered

• LowerAlpha

• UpperAlpha

• LowerRoman

• LowerRoman

Para crear una lista con viñetas o no ordenada, establezca la propiedad BulletStyle en uno de los valores siguientes:

• Disc

• Circle

• Square

Para mostrar las viñetas como imágenes personalizadas, establezca la propiedad BulletStyle en la dirección URL de un gráfico. Se mostrará el mismo gráfico en todos los elementos.

Responder a la selección del usuario

Para obtener información sobre cómo responder a la selección del usuario de los elementos en el control BulletedList , vea Cómo: Responder cuando el usuario hace clic en controles BulletedList de servidor Web  en MSDN Library.

Para obtener una descripción completa de todas las propiedades del control BulletedList , vea BulletedList (Propiedades)  en MSDN Library.

Vea también

Conceptos

Trabajar con sitios ASP.NET
Controles de datos ASP.NET
Controles de validación de ASP.NET
Controles de exploración de ASP.NET
Controles de inicio de sesión de ASP.NET
Controles de elementos web ASP.NET

Otros recursos

Controles estándar ASP.NET