ListBox.SelectionMode-Eigenschaft

Artikel
08/20/2007

Ruft den Auswahlmodus des ListBox-Steuerelements ab oder legt diesen fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable Property SelectionMode As ListSelectionMode
'Usage
Dim instance As ListBox
Dim value As ListSelectionMode

value = instance.SelectionMode

instance.SelectionMode = value

public virtual ListSelectionMode SelectionMode { get; set; }

public:
virtual property ListSelectionMode SelectionMode {
    ListSelectionMode get ();
    void set (ListSelectionMode value);
}

/** @property */
public ListSelectionMode get_SelectionMode ()

/** @property */
public void set_SelectionMode (ListSelectionMode value)

public function get SelectionMode () : ListSelectionMode

public function set SelectionMode (value : ListSelectionMode)

Eigenschaftenwert

Einer der ListSelectionMode-Werte. Der Standardwert ist Single.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentException	Der angegebene Auswahlmodus ist keiner der ListSelectionMode-Werte.

Hinweise

Mit der SelectionMode-Eigenschaft geben Sie das Modusverhalten des ListBox-Steuerelements an. Wenn diese Eigenschaft auf ListSelectionMode.Single festgelegt ist, kann nur ein einzelnes Element des ListBox-Steuerelements ausgewählt werden, während ListSelectionMode.Multiple angibt, dass mehrere Elemente ausgewählt werden können.

Der Wert der SelectionMode-Eigenschaft wird im Ansichtszustand gespeichert.

Thema	Position
Gewusst wie: Festlegen der Auswahl in List-Webserversteuerelementen (Visual Studio)	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Festlegen der Auswahl in List-Webserversteuerelementen (Visual Studio)	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Festlegen der Auswahl in List-Webserversteuerelementen (Visual Studio)	Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von ListBox-Webserversteuerelementen zu einer Web Forms-Seite	Erstellen von ASP.NET-Webanwendungen

Beispiel

Das folgende Beispiel veranschaulicht, wie dem Benutzer mit der SelectionMode-Eigenschaft die Mehrfachauswahl im ListBox-Steuerelement ermöglicht wird.

<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>

   <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 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="C#" AutoEventWireup="True" %>
<html>
<head>

   <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 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>

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

ListBox-Klasse
ListBox-Member
System.Web.UI.WebControls-Namespace
ListSelectionMode

Weitere Ressourcen

ListBox-Webserver-Steuerelement

Freigeben über