HtmlSelect.Multiple Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob mehrere Elemente gleichzeitig im HtmlSelect Steuerelement ausgewählt werden können.
public:
property bool Multiple { bool get(); void set(bool value); };public bool Multiple { get; set; }member this.Multiple : bool with get, setPublic Property Multiple As BooleanEigenschaftswert
true wenn mehrere Elemente gleichzeitig im HtmlSelect Steuerelement ausgewählt werden können; andernfalls false. Der Standardwert ist false.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die Multiple Eigenschaft verwendet wird, um anzugeben, ob mehrere Elemente im HtmlSelect Steuerelement ausgewählt werden können.
<%@ 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>
Hinweise
Verwenden Sie die Multiple Eigenschaft, um anzugeben, ob mehrere Elemente gleichzeitig im HtmlSelect Steuerelement ausgewählt werden können.
Standardmäßig wird das HtmlSelect Steuerelement als Dropdown-Listenfeld angezeigt. Wenn Sie mehrere Auswahlmöglichkeiten zulassen (durch Festlegen der Multiple Eigenschaft auf true) oder eine Höhe größer als eine Zeile angeben (durch Festlegen der Size Eigenschaft auf einen Wert größer als 1), wird das Steuerelement als Listenfeld angezeigt.
Um die ausgewählten Elemente in einem HtmlSelect Steuerelement zu bestimmen, das mehrere gleichzeitige Auswahlen zulässt, durchlaufen Sie die Items Auflistung, und testen Sie die ListItem.Selected Eigenschaft der einzelnen Elemente.
Hinweis
Das multiple Attribut wird nur dann im HtmlSelect Steuerelement gerendert, wenn diese Eigenschaft auf true.
