Freigeben über


ListBox-Klasse

Stellt ein Listenfeld-Steuerelement dar, das die Auswahl eines oder mehrerer Elemente ermöglicht.

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

Syntax

'Declaration
<ValidationPropertyAttribute("SelectedItem")> _
Public Class ListBox
    Inherits ListControl
    Implements IPostBackDataHandler
'Usage
Dim instance As ListBox
[ValidationPropertyAttribute("SelectedItem")] 
public class ListBox : ListControl, IPostBackDataHandler
[ValidationPropertyAttribute(L"SelectedItem")] 
public ref class ListBox : public ListControl, IPostBackDataHandler
/** @attribute ValidationPropertyAttribute("SelectedItem") */ 
public class ListBox extends ListControl implements IPostBackDataHandler
ValidationPropertyAttribute("SelectedItem") 
public class ListBox extends ListControl implements IPostBackDataHandler

Hinweise

Mit dem ListBox-Steuerelement können Sie ein Listensteuerelement erstellen, in dem die Auswahl eines oder mehrerer Elemente möglich ist. Mit der Rows-Eigenschaft geben Sie die Höhe des Steuerelements an. Um die Auswahl mehrerer Elemente zu ermöglichen, legen Sie die SelectionMode-Eigenschaft auf ListSelectionMode.Multiple fest.

Verwenden Sie die Items-Auflistung, um die im ListBox-Steuerelement enthaltenen ListItem-Objekte zu überprüfen. Sie können z. B. die ausgewählten Objekte im ListBox-Steuerelement bestimmen, indem Sie eine Enumeration der Items-Auflistung ausführen und den Selected-Wert für jedes ListItem-Element testen.

Warnung

Dieses Steuerelement kann zum Anzeigen von Benutzereingaben verwendet werden, die möglicherweise böswillige Clientskripts enthalten. Überprüfen Sie alle von einem Client gesendeten Informationen auf ausführbare Skripts, SQL-Anweisungen oder anderen Code, bevor Sie sie in der Anwendung anzeigen. Mithilfe von Validierungssteuerelementen können Sie Benutzereingaben überprüfen, bevor Sie den Eingabetext in einem Steuerelement anzeigen. ASP.NET stellt ein Feature zur Anforderungsvalidierung von Eingaben bereit, um Skripts und HTML in Benutzereingaben zu blockieren. Weitere Informationen finden Sie unter Sichern von Standardsteuerelementen, Gewusst wie: Schutz gegen Skriptangriffe in einer Webanwendung durch Anwenden von HTML-Codierung auf Zeichenfolgen und Überprüfen der Benutzereingabe in ASP.NET-Webseiten.

Eingabehilfen

Das für dieses Steuerelement standardmäßig wiedergegebene Markup entspricht eventuell nicht den Standards für die Eingabehilfen wie beispielsweise den Richtlinien der Web Content Accessibility Guidelines 1.0 (WCAG) mit der Priorität 1. Details über die Unterstützung von Eingabehilfen für dieses Steuerelement finden Sie unter Steuerelemente und Eingabehilfen von ASP.NET.

Thema Position
Exemplarische Vorgehensweise: Erstellen von wiederverwendbaren Elementen mit ASP.NET-Benutzersteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes Geschäftsobjekt 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
Exemplarische Vorgehensweise: Erstellen und Verwenden von ASP.NET-Masterseiten in Visual Web Developer Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von ListBox-Webserversteuerelementen zu einer Web Forms-Seite (Visual Studio) Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Auffüllen von List-Webserversteuerelementen aus einer Datenquelle (Visual Studio) Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von Elementen zu List-Webserversteuerelementen (Visual Studio) Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen von wiederverwendbaren Elementen mit ASP.NET-Benutzersteuerelementen Erstellen von Anwendungen mit Visual Web Developer
Exemplarische Vorgehensweise: Erstellen und Verwenden von ASP.NET-Masterseiten in Visual Web Developer Erstellen von Anwendungen mit Visual Web Developer
Gewusst wie: Festlegen der Auswahl in List-Webserversteuerelementen (Visual Studio) Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Reagieren auf Änderungen in List-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von ListBox-Webserversteuerelementen zu einer Web Forms-Seite (Visual Studio) Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Festlegen des Fokus auf ein ASP.NET-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Auffüllen von List-Webserversteuerelementen aus einer Datenquelle (Visual Studio) Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes Geschäftsobjekt Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von Elementen zu List-Webserversteuerelementen (Visual Studio) Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Bestimmen der Auswahl in List-Webserversteuerelementen 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: Reagieren auf Änderungen in List-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von ListBox-Webserversteuerelementen zu einer Web Forms-Seite (Visual Studio) Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Festlegen des Fokus auf ein ASP.NET-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Auffüllen von List-Webserversteuerelementen aus einer Datenquelle (Visual Studio) Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes Geschäftsobjekt Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von Elementen zu List-Webserversteuerelementen (Visual Studio) Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Bestimmen der Auswahl in List-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Reagieren auf Änderungen in List-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Festlegen des Fokus auf ein ASP.NET-Webserversteuerelement Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Bestimmen der Auswahl in List-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Hinzufügen von ListBox-Webserversteuerelementen zu einer Web Forms-Seite Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Auffüllen von List-Webserversteuerelementen aus einer Datenquelle Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Hinzufügen von Elementen zu List-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Festlegen der Auswahl in List-Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen

Beispiel

Das folgende Beispiel veranschaulicht das Erstellen eines ListBox-Steuerelements.

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

<html>
<head>

   <script language="VB" runat="server">

    Sub SubmitBtn_Click(sender As Object, e As EventArgs)
        If ListBox1.SelectedIndex > - 1 Then
            Label1.Text = "You chose: " & ListBox1.SelectedItem.Text
        End If
    End Sub 'SubmitBtn_Click

  </script>

</head>
<body>

   <h3>ListBox Example</h3>

   <form runat=server>

      <asp:ListBox id="ListBox1" 
           Rows="6"
           Width="100px"
           SelectionMode="Single" 
           runat="server">

         <asp:ListItem>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>

      <asp:button id="Button1"
           Text="Submit" 
           OnClick="SubmitBtn_Click" 
           runat="server" />
        
      <asp:Label id="Label1" 
           Font-Name="Verdana" 
           Font-Size="10pt" 
           runat="server"/>
        
   </form>

</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
<head>

   <script language="C#" runat="server">

      void SubmitBtn_Click(Object sender, EventArgs e) 
      {
         if (ListBox1.SelectedIndex > -1)
            Label1.Text="You chose: " + ListBox1.SelectedItem.Text;
      }

   </script>

</head>
<body>

   <h3>ListBox Example</h3>

   <form runat=server>

      <asp:ListBox id="ListBox1" 
           Rows="6"
           Width="100px"
           SelectionMode="Single" 
           runat="server">

         <asp:ListItem>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>

      <asp:button id="Button1"
           Text="Submit" 
           OnClick="SubmitBtn_Click" 
           runat="server" />
        
      <asp:Label id="Label1" 
           Font-Name="Verdana" 
           Font-Size="10pt" 
           runat="server"/>
        
   </form>

</body>
</html>

Das folgende Beispiel veranschaulicht, wie ein ListBox-Steuerelement unter Verwendung der Datenbindung erstellt wird.

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

<html>
<head>

   <script language="VB" runat="server">

    Sub Page_Load(sender As Object, e As EventArgs)
        
        If Not IsPostBack Then
            
            Dim values As New ArrayList()
            
            values.Add("Item 1")
            values.Add("Item 2")
            values.Add("Item 3")
            values.Add("Item 4")
            values.Add("Item 5")
            values.Add("Item 6")
            
            ListBox1.DataSource = values
            ListBox1.DataBind()
        End If 
    End Sub 'Page_Load

    Sub SubmitBtn_Click(sender As Object, e As EventArgs)
        
        If ListBox1.SelectedIndex > - 1 Then
            Label1.Text = "You chose: " & ListBox1.SelectedItem.Text
        End If 
    End Sub 'SubmitBtn_Click

  </script>

</head>
<body>

   <form runat=server>

        <h3>Data Binding ListBox</h3>
    
        <asp:ListBox id="ListBox1" 
             Width="100px" 
             runat="server"/>

        <asp:button id="Button1"
             Text="Submit" 
             OnClick="SubmitBtn_Click" 
             runat="server" />
        
        <asp:Label id="Label1" 
             font-name="Verdana" 
             font-size="10pt" 
             runat="server"/>

   </form>

</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
<head>

   <script language="C#" runat="server">

      void Page_Load(Object sender, EventArgs e) 
      {

         if (!IsPostBack) 
         {

            ArrayList values = new ArrayList();

            values.Add ("Item 1");
            values.Add ("Item 2");
            values.Add ("Item 3");
            values.Add ("Item 4");
            values.Add ("Item 5");
            values.Add ("Item 6");

            ListBox1.DataSource = values;
            ListBox1.DataBind();

         }

      }

      void SubmitBtn_Click(Object sender, EventArgs e) 
      {
      
         if ( ListBox1.SelectedIndex > -1 )
            Label1.Text = "You chose: " + ListBox1.SelectedItem.Text;
         
      }

   </script>

</head>
<body>

   <form runat=server>

        <h3>Data Binding ListBox</h3>
    
        <asp:ListBox id="ListBox1" 
             Width="100px" 
             runat="server"/>

        <asp:button id="Button1"
             Text="Submit" 
             OnClick="SubmitBtn_Click" 
             runat="server" />
        
        <asp:Label id="Label1" 
             font-name="Verdana" 
             font-size="10pt" 
             runat="server"/>

   </form>

</body>
</html>

.NET Framework-Sicherheit

Vererbungshierarchie

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
       System.Web.UI.WebControls.BaseDataBoundControl
         System.Web.UI.WebControls.DataBoundControl
           System.Web.UI.WebControls.ListControl
            System.Web.UI.WebControls.ListBox

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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-Member
System.Web.UI.WebControls-Namespace
ListControl
ListItem
ListItemCollection

Weitere Ressourcen

ListBox-Webserver-Steuerelement
Sichern von Standardsteuerelementen
Gewusst wie: Schutz gegen Skriptangriffe in einer Webanwendung durch Anwenden von HTML-Codierung auf Zeichenfolgen