Export (0) Print
Expand All

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; }
<asp:BulletedList FirstBulletNumber="Int32" />

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, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

ADD
Show:
© 2015 Microsoft