ListBox.SelectionMode 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定 ListBox 控制項的選取模式。
public:
virtual property System::Web::UI::WebControls::ListSelectionMode SelectionMode { System::Web::UI::WebControls::ListSelectionMode get(); void set(System::Web::UI::WebControls::ListSelectionMode value); };public virtual System.Web.UI.WebControls.ListSelectionMode SelectionMode { get; set; }member this.SelectionMode : System.Web.UI.WebControls.ListSelectionMode with get, setPublic Overridable Property SelectionMode As ListSelectionMode屬性值
其中一個 ListSelectionMode 值。 預設值是 Single。
例外狀況
指定的選取模式不是其中一個 ListSelectionMode 值。
範例
下列範例說明如何使用 SelectionMode 屬性，讓使用者從 ListBox 控制項中選取多個選取專案。
<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>ListBox Example</title>
<script runat="server">
void SubmitBtn_Click(Object sender, EventArgs e)
{
Message.Text = "You chose: <br />";
// Iterate through the Items collection of the ListBox and
// display the selected items.
foreach (ListItem item in ListBox1.Items)
{
if(item.Selected)
{
Message.Text += item.Text + "<br />";
}
}
}
</script>
</head>
<body>
<h3>ListBox Example</h3>
<form id="form1" runat="server">
Select items from the list and click Submit. <br />
<asp:ListBox id="ListBox1"
Rows="6"
Width="100px"
SelectionMode="Multiple"
runat="server">
<asp:ListItem Selected="True">Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:ListBox>
<br /><br />
<asp:button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server" />
<br /><br />
<asp:Label id="Message"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>ListBox Example</title>
<script runat="server">
Sub SubmitBtn_Click(sender As Object, e As EventArgs)
Message.Text = "You chose: <br />"
' Iterate through the Items collection of the ListBox and
' display the selected items.
Dim item As ListItem
For Each item in ListBox1.Items
If item.Selected Then
Message.Text &= item.Text & "<br />"
End If
Next
End Sub
</script>
</head>
<body>
<h3>ListBox Example</h3>
<form id="form1" runat="server">
Select items from the list and click Submit. <br />
<asp:ListBox id="ListBox1"
Rows="6"
Width="100px"
SelectionMode="Multiple"
runat="server">
<asp:ListItem Selected="True">Item 1</asp:ListItem>
<asp:ListItem>Item 2</asp:ListItem>
<asp:ListItem>Item 3</asp:ListItem>
<asp:ListItem>Item 4</asp:ListItem>
<asp:ListItem>Item 5</asp:ListItem>
<asp:ListItem>Item 6</asp:ListItem>
</asp:ListBox>
<br /><br />
<asp:button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server" />
<br /><br />
<asp:Label id="Message"
runat="server"/>
</form>
</body>
</html>
備註
SelectionMode使用 屬性來指定 控制項的 ListBox 模式行為。 將此屬性設定為 ListSelectionMode.Single 表示只能從 ListBox 控制項選取單一專案，同時 ListSelectionMode.Multiple 指定可以選取多個專案。
屬性的值 SelectionMode 會儲存在檢視狀態中。
