HtmlSelect.Multiple Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

Ruft einen Wert ab, der angibt, ob im HtmlSelect-Steuerelement mehrere Elemente gleichzeitig ausgewählt werden können, oder legt diesen fest.

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

Eigenschaftswert

Boolean

true, wenn im HtmlSelect-Steuerelement mehrere Elemente gleichzeitig 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 Dropdownlistenfeld angezeigt. Wenn Sie mehrere Auswahlen zulassen (indem Sie die Multiple Eigenschaft auf truefestlegen) oder eine Höhe größer als eine Zeile angeben (indem Sie die Size Eigenschaft auf einen Wert größer als 1festlegen), 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 jedes Elements.

Hinweis

Das multiple -Attribut wird im HtmlSelect -Steuerelement nur gerendert, wenn diese Eigenschaft auf truefestgelegt ist.

Gilt für:

Weitere Informationen