BulletedList.DisplayMode Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia tryb wyświetlania zawartości listy w kontrolce BulletedList .
public:
virtual property System::Web::UI::WebControls::BulletedListDisplayMode DisplayMode { System::Web::UI::WebControls::BulletedListDisplayMode get(); void set(System::Web::UI::WebControls::BulletedListDisplayMode value); };public virtual System.Web.UI.WebControls.BulletedListDisplayMode DisplayMode { get; set; }member this.DisplayMode : System.Web.UI.WebControls.BulletedListDisplayMode with get, setPublic Overridable Property DisplayMode As BulletedListDisplayModeWartość właściwości
BulletedListDisplayMode Jedna z wartości. Wartość domyślna to Text.
Wyjątki
Określony typ nie jest jedną z BulletedListDisplayMode wartości.
Przykłady
W poniższym przykładzie kodu pokazano, jak utworzyć kontrolkę BulletedList i ustawić DisplayMode właściwość . Kontrolka ListBox jest wypełniana wartościami BulletedListDisplayMode wyliczenia. Format zawartości elementu listy zmienia się w zależności od trybu wyświetlania wybranego przez użytkownika w polu listy.
<%@ 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>DisplayMode Example</title>
<script runat="server">
void Index_Changed(object sender, System.EventArgs e)
{
// Change the message displayed, based on
// the display mode selected from the list box.
if (DisplayModeListBox.SelectedIndex > -1)
{
Message1.Text = "You chose: " + DisplayModeListBox.SelectedItem.Text;
}
// Change the display mode, based on
// the mode selected from the list box.
switch (DisplayModeListBox.SelectedIndex)
{
case 0:
ItemsBulletedList.DisplayMode = BulletedListDisplayMode.Text;
Message2.Text = "";
break;
case 1:
ItemsBulletedList.DisplayMode = BulletedListDisplayMode.HyperLink;
// Opens a new browser window to display the page linked to.
ItemsBulletedList.Target = "_blank";
Message2.Text = "";
break;
case 2:
ItemsBulletedList.DisplayMode = BulletedListDisplayMode.LinkButton;
break;
default:
throw new Exception("You did not select a valid display mode.");
break;
}
}
void ItemsBulletedList_Click(object sender, System.Web.UI.WebControls.BulletedListEventArgs e)
{
// Change the message displayed, based on the index
// of the bulletedlist list item that was clicked.
switch (e.Index)
{
case 0:
Message2.Text = "You clicked list item 1.";
break;
case 1:
Message2.Text = "You clicked list item 2.";
break;
case 2:
Message2.Text = "You clicked list item 3.";
break;
default:
throw new Exception("You did not click a valid list item.");
break;
}
}
</script>
</head>
<body>
<h3>DisplayMode Example</h3>
<form id="form1" runat="server">
<h3>BulletedListDisplayMode Example</h3>
<p>
<asp:BulletedList id="ItemsBulletedList"
BulletStyle="Disc"
DisplayMode="Text"
OnClick="ItemsBulletedList_Click"
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></p>
<hr />
<h4>Select from the list to change the display mode:</h4>
<asp:ListBox id="DisplayModeListBox"
Rows="1"
SelectionMode="Single"
AutoPostBack="True"
OnSelectedIndexChanged="Index_Changed"
runat="server">
<asp:ListItem>Text</asp:ListItem>
<asp:ListItem>Hyperlink</asp:ListItem>
<asp:ListItem>LinkButton</asp:ListItem>
</asp:ListBox>
<asp:Label id="Message1"
runat="server"
AssociatedControlID="DisplayModeListBox"/><br /><br />
<asp:Label id="Message2"
runat="server"
AssociatedControlID="DisplayModeListBox"/>
</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>DisplayMode Example</title>
<script runat="server">
Sub Index_Changed(ByVal sender As Object, ByVal e As System.EventArgs)
' Change the message displayed, based on
' the display mode selected from the list box.
If DisplayModeListBox.SelectedIndex > -1 Then
Message1.Text = "You chose: " & DisplayModeListBox.SelectedItem.Text
End If
' Change the display mode, based on
' the mode selected from the list box.
Select Case (DisplayModeListBox.SelectedIndex)
Case 0
ItemsBulletedList.DisplayMode = BulletedListDisplayMode.Text
Message2.Text = ""
Case 1
ItemsBulletedList.DisplayMode = BulletedListDisplayMode.HyperLink
' Opens a new browser window to display the page linked to.
ItemsBulletedList.Target = "_blank"
Message2.Text = ""
Case 2
ItemsBulletedList.DisplayMode = BulletedListDisplayMode.LinkButton
Case Else
Throw New Exception("You did not select a valid display mode.")
End Select
End Sub
Sub ItemsBulletedList_Click(ByVal sender As Object, _
ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)
' Change the message displayed, based on the index
' of the bulletedlist list item that was clicked.
Select Case (e.Index)
Case 0
Message2.Text = "You clicked list item 1."
Case 1
Message2.Text = "You clicked list item 2."
Case 2
Message2.Text = "You clicked list item 3."
Case Else
Throw New Exception("You did not click a valid list item.")
End Select
End Sub
</script>
</head>
<body>
<h3>DisplayMode Example</h3>
<form id="form1" runat="server">
<h3>BulletedListDisplayMode Example</h3>
<p>
<asp:BulletedList id="ItemsBulletedList"
BulletStyle="Disc"
DisplayMode="Text"
OnClick="ItemsBulletedList_Click"
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></p>
<hr />
<h4>Select from the list to change the display mode:</h4>
<asp:ListBox id="DisplayModeListBox"
Rows="1"
SelectionMode="Single"
AutoPostBack="True"
OnSelectedIndexChanged="Index_Changed"
runat="server">
<asp:ListItem>Text</asp:ListItem>
<asp:ListItem>Hyperlink</asp:ListItem>
<asp:ListItem>LinkButton</asp:ListItem>
</asp:ListBox>
<asp:Label id="Message1"
runat="server"
AssociatedControlID="DisplayModeListBox"/><br /><br />
<asp:Label id="Message2"
runat="server"
AssociatedControlID="DisplayModeListBox"/>
</form>
</body>
</html>
Uwagi
DisplayMode Użyj właściwości , aby określić zachowanie wyświetlania, które ma być stosowane do zawartości elementów listy w kontrolceBulletedList. Właściwość DisplayMode jest ustawiana przy użyciu jednej z BulletedListDisplayMode wartości wyliczenia. W poniższej tabeli wymieniono możliwe wartości.
| Wartość | Wyświetlane jako |
|---|---|
| Text | Tekst. |
| HyperLink | Hiperłącza. |
| LinkButton | Przyciski łącza. |
Wartość HyperLink umożliwia wyświetlanie zawartości listy jako hiperlinków. Po kliknięciu hiperlink przechodzi do adresu URL. Value Użyj właściwości , aby określić adres URL, do którego przechodzi hiperłącze.
Pole LinkButton umożliwia wyświetlanie zawartości listy jako linków. Użyj zdarzenia, BulletedList.Click aby opublikować z powrotem na serwerze po kliknięciu przycisku linku.
Wartość tej właściwości jest przechowywana w stanie widoku.
