BulletedList.FirstBulletNumber Propiedad

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Obtiene o establece el valor inicial de la numeración de los elementos de lista en un control BulletedList ordenado.

public:
 virtual property int FirstBulletNumber { int get(); void set(int value); };

public virtual int FirstBulletNumber { get; set; }

member this.FirstBulletNumber : int with get, set

Public Overridable Property FirstBulletNumber As Integer

Valor de propiedad

Int32

Valor inicial de la numeración de los elementos de lista en un control BulletedList ordenado. El valor predeterminado es 1.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear un BulletedList control y establecer la FirstBulletNumber propiedad para especificar el valor que inicia la numeración de elementos de lista en el BulletedList control . Valor que inicia la numeración de los elementos de lista cambia en función del valor que el usuario escribe en el cuadro de texto.

Importante

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante scripts.

<%@ 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>

<%@ Page Language="VB" %>

<!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">

    Sub Index_Changed(ByVal sender As Object, ByVal e As System.EventArgs)
      
      ' Set the starting number for the bulleted list.
      ItemsBulletedList.FirstBulletNumber = StartValue.Text
      Select Case (BulletStylesListBox.SelectedIndex)
        Case 0
          ItemsBulletedList.BulletStyle = BulletStyle.Numbered
        Case 1
          ItemsBulletedList.BulletStyle = BulletStyle.LowerAlpha
        Case 2
          ItemsBulletedList.BulletStyle = BulletStyle.UpperAlpha
        Case 3
          ItemsBulletedList.BulletStyle = BulletStyle.LowerRoman
        Case 4
          ItemsBulletedList.BulletStyle = BulletStyle.UpperRoman
        Case Else
          Throw New Exception("You did not select a valid bullet style")
      End Select
    End Sub

  </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>

Comentarios

Utilice la FirstBulletNumber propiedad para especificar el valor que inicia la numeración de elementos de lista en un control ordenado BulletedList . El valor que se asigna a la FirstBulletNumber propiedad se omite, si la BulletStyle propiedad se establece en los Discvalores , Square, Circleo CustomImage . Aunque el valor de la FirstBulletNumber propiedad es un entero, no siempre hace que una viñeta se represente como un número. Por ejemplo, si establece la FirstBulletNumber propiedad 4 en y establece la BulletStyle propiedad en el valor LowerAlpha, el primer número de viñeta se representará en minúsculas d.

El valor de esta propiedad se almacena en estado de vista.

Se aplica a