BulletedList.FirstBulletNumber Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define o valor que inicia a numeração de itens de lista em um controle de 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, setPublic Overridable Property FirstBulletNumber As IntegerValor da propriedade
O valor que inicia a numeração de itens de lista em um controle ordenado BulletedList . O padrão é 1.
Exemplos
O exemplo de código a seguir demonstra como criar um BulletedList controle e definir a FirstBulletNumber propriedade para especificar o valor que inicia a numeração de itens de lista no BulletedList controle . O valor que inicia a numeração dos itens de lista é alterado com base no valor que o usuário insere na caixa de texto.
Importante
Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos html ou script. Para obter mais informações, consulte Visão geral de explorações de script.
<%@ 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>
Comentários
Use a FirstBulletNumber propriedade para especificar o valor que inicia a numeração de itens de lista em um controle ordenado BulletedList . O valor atribuído à FirstBulletNumber propriedade será ignorado, se a BulletStyle propriedade estiver definida como os Discvalores , Square, Circleou CustomImage . Embora o valor da FirstBulletNumber propriedade seja um inteiro, nem sempre faz com que um marcador seja renderizado como um número. Por exemplo, se você definir a FirstBulletNumber propriedade 4 como e definir a BulletStyle propriedade como o valor LowerAlpha, o primeiro número de marcador será renderizado como um d em minúsculas.
O valor dessa propriedade é armazenado no estado de exibição.
