HtmlSelect.Multiple-Eigenschaft
Ruft einen Wert ab, der angibt, ob im HtmlSelect-Steuerelement mehrere Elemente gleichzeitig ausgewählt werden können, oder legt diesen fest.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Property Multiple As Boolean
'Usage
Dim instance As HtmlSelect
Dim value As Boolean
value = instance.Multiple
instance.Multiple = value
public bool Multiple { get; set; }
public:
property bool Multiple {
bool get ();
void set (bool value);
}
/** @property */
public boolean get_Multiple ()
/** @property */
public void set_Multiple (boolean value)
public function get Multiple () : boolean
public function set Multiple (value : boolean)
Eigenschaftenwert
true, wenn im HtmlSelect-Steuerelement mehrere Elemente gleichzeitig ausgewählt werden können, andernfalls false. Der Standardwert ist false.
Hinweise
Mit der Multiple-Eigenschaft geben Sie an, ob im HtmlSelect-Steuerelement mehrere Elemente gleichzeitig ausgewählt werden können.
Das HtmlSelect-Steuerelement wird standardmäßig als Dropdown-Listenfeld angezeigt. Wenn Sie Mehrfachauswahl zulassen (durch Festlegen der Multiple-Eigenschaft auf true) oder eine Höhe von mehr als einer Zeile angeben (durch Festlegen der Size-Eigenschaft auf einen Wert größer als 1), wird das Steuerelement als Listenfeld angezeigt.
Zum Bestimmen der ausgewählten Elemente in einem HtmlSelect-Steuerelement, das die Auswahl mehrerer Elemente gleichzeitig zulässt, durchlaufen Sie die Items-Auflistung, und testen Sie die ListItem.Selected-Eigenschaft der einzelnen Elemente.
Hinweis
Das multiple-Attribut wird im HtmlSelect-Steuerelement nur dargestellt, wenn diese Eigenschaft auf true festgelegt ist.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mit der Multiple-Eigenschaft angegeben wird, ob im HtmlSelect-Steuerelement mehrere Elemente ausgewählt werden können.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<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 i
Select1.Size = CInt(Select2.Value)
End Sub
Sub Check_Changed (sender As Object, e As EventArgs)
Select1.Multiple = CheckBox1.Checked
End Sub
</script>
</head>
<body>
<form runat="server">
<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="True"> 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="True"> 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"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<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>
</head>
<body>
<form runat="server">
<h3> HtmlSelect Example </h3>
Select item(s) from the list: <br><br>
<select id="Select1"
Multiple="True"
runat="server">
<option value="1" Selected="True"> 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="True"> 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"/>
</form>
</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
function Button_Click (sender: Object, e : EventArgs) : void
{
Label1.Text = "You selected:";
for (var i: int =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);
}
function Check_Changed (sender : Object, e : EventArgs) : void
{
Select1.Multiple = CheckBox1.Checked;
}
</script>
</head>
<body>
<form runat="server">
<h3> HtmlSelect Example </h3>
Select item(s) from the list: <br><br>
<select id="Select1"
Multiple="True"
runat="server">
<option value="1" Selected="True"> 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="True"> 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"/>
</form>
</body>
</html>
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
HtmlSelect-Klasse
HtmlSelect-Member
System.Web.UI.HtmlControls-Namespace
Size