BulletedList.FirstBulletNumber Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Wert ab, mit dem die Nummerierung der Listenelemente in einem geordneten BulletedList-Steuerelement beginnen soll, oder legt diesen Wert fest.
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 IntegerEigenschaftswert
Der Wert, mit dem die Nummerierung der Listenelemente in einem geordneten BulletedList-Steuerelement beginnen soll. Der Standardwert lautet 1.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein BulletedList Steuerelement erstellen und die FirstBulletNumber Eigenschaft festlegen, um den Wert anzugeben, der die Nummerierung von Listenelementen im BulletedList Steuerelement startet. Der Wert, der die Nummerierung der Listenelemente startet, ändert sich basierend auf dem Wert, den der Benutzer in das Textfeld eingibt.
Wichtig
Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.
<%@ 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>
Hinweise
Verwenden Sie die FirstBulletNumber Eigenschaft, um den Wert anzugeben, der die Nummerierung von Listenelementen in einem sortierten BulletedList Steuerelement startet. Der Wert, der der FirstBulletNumber Eigenschaft zugewiesen ist, wird ignoriert, wenn die BulletStyle Eigenschaft auf die DiscSquareWerte , Circleoder CustomImage werte festgelegt ist. Obwohl der Wert der FirstBulletNumber Eigenschaft eine ganze Zahl ist, führt sie nicht immer dazu, dass ein Aufzählungszeichen als Zahl gerendert wird. Wenn Sie beispielsweise die FirstBulletNumber Eigenschaft auf den Wert festlegen und die Eigenschaft 4 auf den Wert LowerAlphafestlegenBulletStyle, wird die erste Aufzählungszeichennummer als Kleinbuchstaben d gerendert.
Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.