In this topic:

• Introduction

• Accessibility

• Declarative Syntax

Introduction

Use the System.Web.UI.WebControls.BulletedList control to create a list of items that are formatted with bullets. To specify the individual list items that you want to appear in a System.Web.UI.WebControls.BulletedList control, place a System.Web.UI.WebControls.ListItem object for each entry between the opening and closing tags of the System.Web.UI.WebControls.BulletedList control.

To specify the bullet type to use to display list items in a System.Web.UI.WebControls.BulletedList control, set the BulletedList.BulletStyle property to one of the bullet types that are defined by the System.Web.UI.WebControls.BulletStyle enumeration. The following table lists the available bullet styles.

Use the BulletedList.FirstBulletNumber property to specify the value that starts the numbering of list items in an ordered System.Web.UI.WebControls.BulletedList control. The value that is assigned to the BulletedList.FirstBulletNumber property is ignored, if the BulletedList.BulletStyle property is set to the BulletStyle.Disc, BulletStyle.Square, BulletStyle.Circle, or BulletStyle.CustomImage field. If you set the BulletedList.BulletStyle property to the value of BulletStyle.CustomImage to specify a custom image for the bullet, you must set the BulletedList.BulletImageUrl property also to specify the location of the image file.

To specify the display behavior of the list items in a System.Web.UI.WebControls.BulletedList, set the BulletedList.DisplayMode property to one of the values that are defined by the System.Web.UI.WebControls.BulletedListDisplayMode enumeration. The defined display behaviors are BulletedListDisplayMode.Text, BulletedListDisplayMode.HyperLink, and BulletedListDisplayMode.LinkButton.

When a hyperlink is clicked, it navigates to a URL. Use the ListItem.Value property to specify the URL that a hyperlink navigates to. Use the BulletedList.Target property to specify the frame or window that displays the Web page that is navigated to when a hyperlink is clicked.

When the BulletedList.DisplayMode property is set to BulletedListDisplayMode.LinkButton, the System.Web.UI.WebControls.BulletedList control displays list items as links that post back to the server when clicked. To programmatically control the actions that are performed when a link button is clicked, provide an event handler for the BulletedList.Click event. Note that the BulletedList.SelectedIndex and BulletedList.SelectedItem properties are inherited from the System.Web.UI.WebControls.ListControl class and are not applicable to the System.Web.UI.WebControls.BulletedList control. Use the event data of the System.Web.UI.WebControls.BulletedListEventArgs class to determine the index of the link button in a System.Web.UI.WebControls.BulletedList that was clicked.

The System.Web.UI.WebControls.BulletedList control also supports data binding. To bind the System.Web.UI.WebControls.BulletedList to a data source, you can use any of the provided data-binding mechanisms. For more information, see Binding to Databases.

Accessibility

The markup rendered by default for this control might not conform to accessibility standards such as the Web Content Accessibility Guidelines 1.0 (WCAG) priority 1 guidelines. For details about accessibility support for this control, see ASP.NET Controls and Accessibility.

Declarative Syntax

<asp:BulletedList
    AccessKey="string"
    AppendDataBoundItems="True|