HtmlSelect.Multiple 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定值,指出是否可以同時選取 HtmlSelect 控制項中的多個項目。
public:
property bool Multiple { bool get(); void set(bool value); };
public bool Multiple { get; set; }
member this.Multiple : bool with get, set
Public Property Multiple As Boolean
屬性值
如果可以同時選取 HtmlSelect 控制項中的多個項目,則為 true
;否則,即為 false
。 預設值是 false
。
範例
下列程式碼範例示範如何使用 Multiple 屬性來指定是否可以在 控制項中 HtmlSelect 選取多個專案。
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Button_Click (Object sender, EventArgs e)
{
Label1.Text = "You selected:";
for (int i=0; i<=Select1.Items.Count - 1; i++)
{
if (Select1.Items[i].Selected)
Label1.Text += "<br /> -" + Select1.Items[i].Text;
}
Select1.Size = Convert.ToInt32(Select2.Value);
}
void Check_Changed (Object sender, EventArgs e)
{
Select1.Multiple = CheckBox1.Checked;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> HtmlSelect Example </title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3> HtmlSelect Example </h3>
Select item(s) from the list: <br /><br />
<select id="Select1"
multiple="true"
runat="server">
<option value="1" selected="selected"> Item 1 </option>
<option value="2"> Item 2 </option>
<option value="3"> Item 3 </option>
<option value="4"> Item 4 </option>
<option value="5"> Item 5 </option>
<option value="6"> Item 6 </option>
</select>
<hr />
HtmlSelect Size: <br />
<select id="Select2"
runat="server">
<option value="1"> 1 </option>
<option value="2"> 2 </option>
<option value="3"> 3 </option>
<option value="4" selected="selected"> 4 </option>
<option value="5"> 5 </option>
<option value="6"> 6 </option>
</select>
<asp:CheckBox id="CheckBox1"
Text="Enable Multiple Property"
AutoPostBack="True"
OnCheckedChanged="Check_Changed"
Checked="True"
runat="server"/>
<br /><br />
<button id="Button1"
onserverclick="Button_Click"
runat="server">
Submit
</button>
<br /><br />
<asp:Label id="Label1" runat="server"/>
</div>
</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">
<script runat="server">
Sub Button_Click (sender As Object, e As EventArgs)
Dim i As Integer
Label1.Text = "You selected:"
For i = 0 to Select1.Items.Count - 1
If Select1.Items(i).Selected Then
Label1.Text = Label1.Text & "<br /> -" & Select1.Items(i).Text
End If
Next
Select1.Size = CInt(Select2.Value)
End Sub
Sub Check_Changed (sender As Object, e As EventArgs)
Select1.Multiple = CheckBox1.Checked
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> HtmlSelect Example </title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3> HtmlSelect Example </h3>
Select item(s) from the list: <br /><br />
<select id="Select1"
multiple="true"
runat="server">
<option value="1"> Item 1 </option>
<option value="2"> Item 2 </option>
<option value="3"> Item 3 </option>
<option value="4" selected="selected"> Item 4 </option>
<option value="5"> Item 5 </option>
<option value="6"> Item 6 </option>
</select>
<hr />
HtmlSelect Size: <br />
<select id="Select2"
runat="server">
<option value="1" selected="selected"> 1 </option>
<option value="2"> 2 </option>
<option value="3"> 3 </option>
<option value="4"> 4 </option>
<option value="5"> 5 </option>
<option value="6"> 6 </option>
</select>
<asp:CheckBox id="CheckBox1"
Text="Enable Multiple Property"
AutoPostBack="True"
OnCheckedChanged="Check_Changed"
Checked="True"
runat="server"/>
<br /><br />
<button id="Button1"
onserverclick="Button_Click"
runat="server">
Submit
</button>
<br /><br />
<asp:Label id="Label1" runat="server"/>
</div>
</form>
</body>
</html>
備註
Multiple使用 屬性可指定是否可以在 控制項中 HtmlSelect 同時選取多個專案。
根據預設, HtmlSelect 控制項會顯示為下拉式清單方塊。 如果您允許多個選取 (專案,方法是將 屬性設定 Multiple 為 true
) ,或藉由將 Size 屬性設定為大於) 的值 1
,指定大於 (一列的高度,控制項會顯示為清單方塊。
若要判斷控制項中允許多個同時選取專案的選取專案,請逐一 HtmlSelect 查看 Items 集合並測試 ListItem.Selected 每個專案的 屬性。
注意
multiple
只有在此屬性設定 true
為 時, HtmlSelect 屬性才會在 控制項中轉譯。