BulletedList.FirstBulletNumber 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定已排序之 BulletedList 控制項中清單項目編號的起始值。
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 Integer屬性值
在已排序之 BulletedList 控制項中清單項目編號的起始值。 預設為 1。
範例
下列程式碼範例示範如何建立 BulletedList 控制項，並設定 FirstBulletNumber 屬性來指定值，以啟動 控制項中的 BulletedList 清單專案編號。 啟動清單專案編號的值會根據使用者在文字方塊中輸入的值而變更。
重要
這個範例有一個可接受使用者輸入的文字方塊，這可能會造成安全性威脅。 根據預設，ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。 如需詳細資訊，請參閱 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>
<%@ 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>
備註
FirstBulletNumber使用 屬性來指定值，以啟動已排序 BulletedList 控制項中的清單專案編號。 如果 BulletStyle 屬性設定 Disc 為 、 Square 、 Circle 或 CustomImage 值，則會忽略指派給 FirstBulletNumber 屬性的值。 雖然屬性的值 FirstBulletNumber 是整數，但它不一定會導致專案符號呈現為數字。 例如，如果您將 FirstBulletNumber 屬性 4 設定為 ，並將 屬性設定 BulletStyle 為 值 LowerAlpha ，則第一個專案符號編號會轉譯為小寫 d。
此屬性的值會儲存在檢視狀態中。