BulletedList.BulletStyle Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает стиль маркера для элемента управления BulletedList.
public:
virtual property System::Web::UI::WebControls::BulletStyle BulletStyle { System::Web::UI::WebControls::BulletStyle get(); void set(System::Web::UI::WebControls::BulletStyle value); };public virtual System.Web.UI.WebControls.BulletStyle BulletStyle { get; set; }member this.BulletStyle : System.Web.UI.WebControls.BulletStyle with get, setPublic Overridable Property BulletStyle As BulletStyleЗначение свойства
Одно из значений перечисления BulletStyle. Значение по умолчанию — NotSet.
Исключения
Указанный тип не является одним из значений BulletStyle.
Примеры
В следующем примере кода показано, как создать BulletedList элемент управления . Элемент ListBox управления заполняется всеми доступными BulletStyle значениями перечисления. Стиль маркеров изменяется в зависимости от стиля, выбранного пользователем в списке.
<%@ 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>
BulletStyle Example</title>
<script runat="server">
protected void Index_Changed(object sender, EventArgs e)
{
// Change the message displayed, based on
// the style selected from the list box.
if (BulletStylesListBox.SelectedIndex > -1)
{
Message.Text = "You selected bullet style: " +
BulletStylesListBox.SelectedItem.Text;
}
// Change the bullet style used, based on
// the style selected from the list box.
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;
case 5:
ItemsBulletedList.BulletStyle = BulletStyle.Disc;
break;
case 6:
ItemsBulletedList.BulletStyle = BulletStyle.Circle;
break;
case 7:
ItemsBulletedList.BulletStyle = BulletStyle.Square;
break;
case 8:
ItemsBulletedList.BulletStyle = BulletStyle.CustomImage;
// Specify the path to the custom image to use for the bullet.
ItemsBulletedList.BulletImageUrl = "Images/image1.jpg";
break;
case 9:
Message.Text = "You selected NotSet. The browser will determine the bullet style.";
break;
default:
throw new Exception("You did not select a valid bullet style.");
}
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>
BulletStyle Example</h3>
<asp:BulletedList ID="ItemsBulletedList" DisplayMode="Text" BulletStyle="NotSet"
runat="server">
<asp:ListItem Value="0">Coho Winery</asp:ListItem>
<asp:ListItem Value="1">Contoso, Ltd.</asp:ListItem>
<asp:ListItem Value="2">Tailspin Toys</asp:ListItem>
</asp:BulletedList>
<hr />
<h4>
Select a bullet type:</h4>
<asp:ListBox ID="BulletStylesListBox" SelectionMode="Single" Rows="1" OnSelectedIndexChanged="Index_Changed"
AutoPostBack="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:ListItem>Disc</asp:ListItem>
<asp:ListItem>Circle</asp:ListItem>
<asp:ListItem>Square</asp:ListItem>
<asp:ListItem>CustomImage</asp:ListItem>
<asp:ListItem Value="NotSet">NotSet</asp:ListItem>
</asp:ListBox>
<hr />
<asp:Label ID="Message" runat="server" AssociatedControlID="BulletStylesListBox" />
</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>BulletStyle Example</title>
<script runat="server">
Sub Index_Changed(ByVal sender As Object, ByVal e As System.EventArgs)
' Change the message displayed, based on
' the style selected from the list box.
If BulletStylesListBox.SelectedIndex > -1 Then
Message.Text = "You selected bullet style: " & BulletStylesListBox.SelectedItem.Text
End If
' Change the bullet style used, based on
' the style selected from the list box.
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 5
ItemsBulletedList.BulletStyle = BulletStyle.Disc
Case 6
ItemsBulletedList.BulletStyle = BulletStyle.Circle
Case 7
ItemsBulletedList.BulletStyle = BulletStyle.Square
Case 8
ItemsBulletedList.BulletStyle = BulletStyle.CustomImage
' Specify the path to the custom image to use for the bullet.
ItemsBulletedList.BulletImageUrl = "Images/image1.jpg"
Case 9
Message.Text = "You selected NotSet. The browser will determine the bullet style."
Case Else
Throw New Exception("You did not select a valid bullet style.")
End Select
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>BulletStyle Example</h3>
<asp:BulletedList id="ItemsBulletedList"
DisplayMode="Text"
BulletStyle="NotSet"
runat="server">
<asp:ListItem Value="0">Coho Winery</asp:ListItem>
<asp:ListItem Value="1">Contoso, Ltd.</asp:ListItem>
<asp:ListItem Value="2">Tailspin Toys</asp:ListItem>
</asp:BulletedList>
<hr />
<h4>Select a bullet type:</h4>
<asp:ListBox id="BulletStylesListBox"
SelectionMode="Single"
Rows="1"
OnSelectedIndexChanged="Index_Changed"
AutoPostBack="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:ListItem>Disc</asp:ListItem>
<asp:ListItem>Circle</asp:ListItem>
<asp:ListItem>Square</asp:ListItem>
<asp:ListItem>CustomImage</asp:ListItem>
<asp:ListItem Value="NotSet">NotSet</asp:ListItem>
</asp:ListBox>
<hr />
<asp:Label id="Message"
runat="server"
AssociatedControlID="BulletStylesListBox"/>
</form>
</body>
</html>
Комментарии
Используйте свойство , BulletStyle чтобы указать стиль маркеров, применяемый к элементам списка в элементе BulletedList управления . Свойство BulletStyle задается с помощью одного из значений BulletStyle перечисления. В следующей таблице перечислены возможные значения.
| Стиль маркеров | Описание |
|---|---|
| NotSet | Не задано. |
| Numbered | Число. |
| LowerAlpha | Строчная буква. |
| UpperAlpha | Прописная буква. |
| LowerRoman | Римские цифры в нижнем регистре. |
| UpperRoman | Прописная римская цифра. |
| Disc | Заполненный круг. |
| Circle | Пустой круг. |
| Square | Заполненный квадрат. |
| CustomImage | Пользовательский образ. |
Если указать значение, CustomImage вы можете указать собственный образ для маркера. При указании CustomImage значения необходимо также задать BulletImageUrl для свойства URL-адрес используемого пользовательского образа.
Примечание
Элемент BulletedList управления не поддерживает свойство , AlternateText так как маркеры по своей сути являются декоративными и не предоставляют дополнительную информацию, которую необходимо передать с помощью специальных возможностей. Однако если вы хотите использовать пользовательское изображение для передачи концепции пользователю, следует добавить дополнительный текст к каждому элементу маркированного списка или использовать элемент управления, позволяющий указать альтернативный текст для каждого изображения.
Значение этого свойства хранится в состоянии представления.
