Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Actualización: noviembre 2007
El control BulletedList crea una lista de elementos ordenados y no ordenados (numerados) que se representa con un elemento 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 datos al control, y puede responder a los clics que los usuarios hacen en los elementos.
Definir elementos de lista
El control BulletedList se deriva de la misma clase ListControl que el control ListBox, DropDownList y otros controles de lista de ASP.NET, por lo que su uso es similar a trabajar con estos controles. Puede definir los elementos de lista del control BulletedList creando elementos estáticos o enlazando el control a un origen de datos. Si conoce en tiempo de diseño qué elementos desea mostrar, puede establecer la colección Items del control en un conjunto de elementos individuales de marcado. Si los elementos que se van a mostrar son dinámicos, puede crear la colección de elementos mediante código en tiempo de ejecución. Para obtener información detallada, vea Cómo: Agregar elementos a controles List de servidor Web.
Si lo desea, puede enlazar también el control a un origen de datos que contenga la información que desea mostrar. Para obtener información detallada, vea Cómo: Rellenar controles List de servidor Web desde 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 del control BulletedList, se definen dos propiedades: la propiedad Text y la propiedad 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.
.gif "Nota de seguridad") Nota de seguridad: |
|---|
No utilice datos confidenciales, como números de cliente, en la propiedad de un control BulletedList. Aunque no puedan verses, los valores de la propiedad Value de los elementos individuales se representan en la página, y los usuarios podrán verlos con facilidad en el código fuente de la página. |
Personalizar el aspecto de un elemento de lista
El control BulletedList puede representar viñetas o números, según 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.
.gif "Nota") 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, UpperAlpha, LowerRoman y UpperAlpha. Al definir la propiedad FirstBulletNumber, puede especificar también un número inicial para la secuencia.
Especificar el modo de presentación de un elemento
El control BulletedList puede mostrar los elementos de lista como:
Texto estático El texto mostrado por el control no es interactivo.
Controles T:System.Web.UI.WebControls.HyperLink Los usuarios pueden hacer clic en los vínculos para desplazarse a otra página. Debe proporcionar una dirección URL de destino como valor de la propiedad Value de los elementos individuales.
LinkButton(controles) Los usuarios pueden hacer clic en los elementos individuales y el control realiza una devolución de datos.
Responder a la selección del usuario
Si el control BulletedList se configura para que muestre los elementos como controles LinkButton, el control realiza una devolución de datos cuando un usuario hace clic en un elemento. La devolución de datos desencadena el evento Click del control BulletedList, en el que puede incluir una lógica que realice tareas específicas de la aplicación. El evento le transfiere el número de índice del elemento en el que se hizo clic. Para obtener información detallada, vea Cómo: Responder cuando el usuario hace clic en controles BulletedList de servidor Web.