BulletedList.FirstBulletNumber Property

Gets or sets the value that starts the numbering of list items in an ordered BulletedList control.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public virtual int FirstBulletNumber { get; set; }

Property Value

Type: System.Int32
The value that starts the numbering of list items in an ordered BulletedList control. The default is 1.

Use the FirstBulletNumber property to specify the value that starts the numbering of list items in an ordered BulletedList control. The value that is assigned to the FirstBulletNumber property is ignored, if the BulletStyle property is set to the Disc, Square, Circle, or CustomImage values. Although the value of the FirstBulletNumber property is an integer, it does not always cause a bullet to render as a number. For example, if you set the FirstBulletNumber property to 4 and set the BulletStyle property to the value LowerAlpha, the first bullet number will render as a lowercase d.

The value of this property is stored in view state.

The following code example demonstrates how to create a BulletedList control and set the FirstBulletNumber property to specify the value that starts the numbering of list items in the BulletedList control. The value that starts the numbering of the list items changes based on the value that the user enters in the text box.

Security noteSecurity Note

This example has a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>First Bullet Number Example</title>
  <script runat="server">

    void Index_Changed(object sender, System.EventArgs e)
    {
	    
      // Set the starting number for the bulleted list.
	    ItemsBulletedList.FirstBulletNumber = Convert.ToInt32(StartValue.Text);
	    switch (BulletStylesListBox.SelectedIndex) 
      {
		    case 0:
			    ItemsBulletedList.BulletStyle = BulletStyle.Numbered;
			    break;
		    case 1:
			    ItemsBulletedList.BulletStyle = BulletStyle.LowerAlpha;
			    break;
		    case 2:
			    ItemsBulletedList.BulletStyle = BulletStyle.UpperAlpha;
			    break;
		    case 3:
			    ItemsBulletedList.BulletStyle = BulletStyle.LowerRoman;
			    break;
		    case 4:
			    ItemsBulletedList.BulletStyle = BulletStyle.UpperRoman;
			    break;
		    default:
			    throw new Exception("You did not select a valid bullet style");
			    break;
	    }
    }

  </script>

</head>
<body>

  <h3>First Bullet Number Example</h3>

  <form id="form1" runat="server">

    <asp:BulletedList id="ItemsBulletedList"             
      BulletStyle="Disc" 
      DisplayMode="Text"
      runat="server">    
        <asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
        <asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
        <asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
    </asp:BulletedList>    

    <hr />

    <h4>Enter the first number to start the list</h4>        

    <asp:TextBox id="StartValue" 
      Text="1"
      runat="server">
    </asp:TextBox><br />    

    <asp:RangeValidator id="Range1" 
      ControlToValidate="StartValue"
      MinimumValue="1"
      MaximumValue="32000"
      Type="Integer"
      ErrorMessage="Please enter a number greater than zero and less than 32,000."
      runat="server">
    </asp:RangeValidator><br />            

    <h4>Select a bullet type:</h4>
    <asp:ListBox id="BulletStylesListBox" 
      SelectionMode="Single"
      Rows="1"
      AutoPostBack="True"
      OnSelectedIndexChanged="Index_Changed"
      CausesValidation="true"
      runat="server" >        
        <asp:ListItem Value="Numbered">Numbered</asp:ListItem>
        <asp:ListItem Value="LowerAlpha">LowerAlpha</asp:ListItem>
        <asp:ListItem Value="UpperAlpha">UpperAlpha</asp:ListItem>
        <asp:ListItem Value="LowerRoman">LowerRoman</asp:ListItem>
        <asp:ListItem Value="UpperRoman">UpperRoman</asp:ListItem>       
    </asp:ListBox><br />

    <hr />
  </form>

</body>
</html>

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft