BulletedList.FirstBulletNumber Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta il valore di inizio della numerazione degli elementi dell'elenco in un controllo BulletedList ordinato.
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 IntegerValore della proprietà
Valore di inizio della numerazione degli elementi dell'elenco in un controllo BulletedList ordinato. Il valore predefinito è 1.
Esempio
Nell'esempio di codice seguente viene illustrato come creare un BulletedList controllo e impostare la FirstBulletNumber proprietà per specificare il valore che avvia la numerazione degli elementi di elenco nel BulletedList controllo . Il valore che avvia la numerazione degli elementi dell'elenco cambia in base al valore immesso dall'utente nella casella di testo.
Importante
L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite 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>
Commenti
Utilizzare la FirstBulletNumber proprietà per specificare il valore che avvia la numerazione delle voci di elenco in un controllo ordinato BulletedList . Il valore assegnato alla FirstBulletNumber proprietà viene ignorato, se la BulletStyle proprietà è impostata sui Discvalori , Square, Circleo CustomImage . Anche se il valore della FirstBulletNumber proprietà è un numero intero, non comporta sempre il rendering di un punto elenco come numero. Ad esempio, se si imposta la FirstBulletNumber proprietà su 4 e si imposta la BulletStyle proprietà sul valore LowerAlpha, il primo numero del punto elenco verrà visualizzato come minuscolo d.
Il valore di questa proprietà viene archiviato nello stato di visualizzazione.
