BulletedList.DisplayMode 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定 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, set
Public Overridable Property DisplayMode As BulletedListDisplayMode
屬性值
其中一個 BulletedListDisplayMode 值。 預設值為 Text。
例外狀況
指定的類型不是其中一個 BulletedListDisplayMode 值。
範例
下列程式碼範例示範如何建立 BulletedList 控制項並設定 DisplayMode 屬性。 控制項 ListBox 會填入 BulletedListDisplayMode 列舉值。 清單專案內容的格式會根據使用者從清單方塊中選取的顯示模式而變更。
<%@ 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>
備註
DisplayMode使用 屬性來指定要套用至 控制項中 BulletedList 清單專案內容的顯示行為。 屬性 DisplayMode 是使用其中 BulletedListDisplayMode 一個列舉值來設定。 下表列出可能的值。
值 | 顯示為 |
---|---|
Text | Text。 |
HyperLink | 連結。 |
LinkButton | 連結按鈕。 |
值 HyperLink 可讓您將清單內容顯示為超連結。 按一下時,超連結會巡覽至 URL。 Value使用 屬性來指定超連結巡覽至的 URL。
欄位 LinkButton 可讓您將清單內容顯示為連結。 按一下連結按鈕時,使用 BulletedList.Click 事件回傳至伺服器。
這個屬性的值會儲存在檢視狀態中。
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應