Freigeben über


DropDownList-Klasse

Stellt ein Steuerelement dar, das dem Benutzer die Auswahl eines einzelnen Elements aus einer Dropdownliste ermöglicht.

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

Syntax

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

Hinweise

Mit dem DropDownList-Steuerelement können Sie ein Dropdownlisten-Steuerelement mit einfacher Auswahl erstellen. Sie können die Darstellung des DropDownList-Steuerelements steuern, indem Sie die BorderColor-Eigenschaft, die BorderStyle-Eigenschaft und die BorderWidth-Eigenschaft festlegen.

Wenn Sie die im DropDownList-Steuerelement darzustellenden Elemente angeben möchten, platzieren Sie für jeden Eintrag ein ListItem-Objekt zwischen dem öffnenden und dem schließenden Tag des DropDownList-Steuerelements.

Das DropDownList-Steuerelement unterstützt auch die Datenbindung. Sie können das Steuerelement an eine Datenquelle binden, indem Sie eine Datenquelle erstellen, die alle im Steuerelement anzuzeigenden Elemente enthält, z. B. ein System.Collections.ArrayList-Objekt. Anschließend binden Sie die Datenquelle mithilfe der Control.DataBind-Methode an das DropDownList-Steuerelement.

Ermitteln Sie mit der SelectedIndex-Eigenschaft programmgesteuert den Index des vom Benutzer im DropDownList-Steuerelement ausgewählten Elements.

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: Anzeigen formatierter Daten in Webseiten mit dem FormView-Webserver-Steuerelement Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Erstellen einer Webseite zum Anzeigen von XML-Daten Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes Geschäftsobjekt Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Anzeigen eines XML-Dokuments in einer Web Forms-Seite mithilfe von Transformationen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von DropDownList-Webserversteuerelementen zu einer Web Forms-Seite (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
Exemplarische Vorgehensweise: Erstellen und Verwenden von ASP.NET-Masterseiten in Visual Web Developer 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: Anzeigen einer Dropdownliste während das Bearbeitens im GridView-Webserver-Steuerelement 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 Master-Detail-Webseiten in 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 Anwendungen mit Visual Web Developer
Exemplarische Vorgehensweise: Anzeigen einer Dropdownliste während das Bearbeitens im GridView-Webserver-Steuerelement Erstellen von Anwendungen mit Visual Web Developer
Exemplarische Vorgehensweise: Erstellen von Master-Detail-Webseiten in Visual Studio 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 DropDownList-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
Exemplarische Vorgehensweise: Anzeigen formatierter Daten in Webseiten mit dem FormView-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: Erstellen einer Webseite zum Anzeigen von XML-Daten Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Datenbindung an ein benutzerdefiniertes Geschäftsobjekt Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Anzeigen einer Dropdownliste während das Bearbeitens im GridView-Webserver-Steuerelement dv_vwdcon
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: Anzeigen von Siteübersichtsdaten in nicht hierarchischen Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Anzeigen eines XML-Dokuments in einer Web Forms-Seite mithilfe von Transformationen 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 DropDownList-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
Exemplarische Vorgehensweise: Anzeigen formatierter Daten in Webseiten mit dem FormView-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: Erstellen einer Webseite zum Anzeigen von XML-Daten 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: Anzeigen von Siteübersichtsdaten in nicht hierarchischen Webserversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Anzeigen eines XML-Dokuments in einer Web Forms-Seite mithilfe von Transformationen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Hinzufügen von DropDownList-Webserversteuerelementen zu einer Web Forms-Seite Erstellen von ASP.NET-Webanwendungen
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: Auffüllen von List-Webserversteuerelementen aus einer Datenquelle Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Anzeigen von Siteübersichtsdaten in nicht hierarchischen Webserversteuerelementen 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

Im folgenden Codebeispiel wird das Erstellen eines DropDownList-Steuerelements veranschaulicht, das vier Elemente enthält.

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

<html>
   <script runat="server" >
  
      Sub Selection_Change(sender As Object, e As EventArgs)

         ' Set the background color for days in the Calendar control
         ' based on the value selected by the user from the
         '  DropDownList control.
         Calendar1.DayStyle.BackColor = _
             System.Drawing.Color.FromName(ColorList.SelectedItem.Value)

      End Sub
  
   </script>
  
<body>

   <form runat="server">
  
      <h3> DropDownList Example </h3>

      Select a background color for days in the calendar.

      <br><br> 
  
      <asp:Calendar id="Calendar1"
           ShowGridLines="True" 
           ShowTitle="True"
           runat="server"/>

      <br><br>

      <table cellpadding="5">

         <tr>

            <td>

               Background color:

            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="ColorList"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Selection_Change"
                    runat="server">

                  <asp:ListItem Selected="True" Value="White"> White </asp:ListItem>
                  <asp:ListItem Value="Silver"> Silver </asp:ListItem>
                  <asp:ListItem Value="DarkGray"> Dark Gray </asp:ListItem>
                  <asp:ListItem Value="Khaki"> Khaki </asp:ListItem>
                  <asp:ListItem Value="DarkKhaki"> Dark Khaki </asp:ListItem>

               </asp:DropDownList>

            </td>

         </tr>
  
   </form>

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

<html>
   <script runat="server" >
  
      void Selection_Change(Object sender, EventArgs e)
      {

         // Set the background color for days in the Calendar control
         // based on the value selected by the user from the 
         // DropDownList control.
         Calendar1.DayStyle.BackColor = 
             System.Drawing.Color.FromName(ColorList.SelectedItem.Value);

      }
  
   </script>
  
<body>

   <form runat="server">
  
      <h3> DropDownList Example </h3>

      Select a background color for days in the calendar.

      <br><br> 
  
      <asp:Calendar id="Calendar1"
           ShowGridLines="True" 
           ShowTitle="True"
           runat="server"/>

      <br><br>

      <table cellpadding="5">

         <tr>

            <td>

               Background color:

            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="ColorList"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Selection_Change"
                    runat="server">

                  <asp:ListItem Selected="True" Value="White"> White </asp:ListItem>
                  <asp:ListItem Value="Silver"> Silver </asp:ListItem>
                  <asp:ListItem Value="DarkGray"> Dark Gray </asp:ListItem>
                  <asp:ListItem Value="Khaki"> Khaki </asp:ListItem>
                  <asp:ListItem Value="DarkKhaki"> Dark Khaki </asp:ListItem>

               </asp:DropDownList>

            </td>

         </tr>
  
   </form>

</body>
</html>
 

Im folgenden Codebeispiel wird das Erstellen eines DropDownList-Steuerelements unter Verwendung der Datenbindung veranschaulicht.

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<html>
   <script runat="server" >
  
      Sub Selection_Change(sender as Object, e As EventArgs)

         ' Set the background color for days in the Calendar control 
         ' based on the value selected by the user from the
         ' DropDownList control.
         Calendar1.DayStyle.BackColor = _
             System.Drawing.Color.FromName(ColorList.SelectedItem.Value)

      End Sub

      Sub Page_Load(sender as Object, e As EventArgs)
  
         ' Load data for the DropDownList control only once, when the 
         ' page is first loaded.
         If Not IsPostBack Then

            ' Specify the data source and field names for the Text 
            ' and Value properties of the items (ListItem objects)
            ' in the DropDownList control.
            ColorList.DataSource = CreateDataSource()
            ColorList.DataTextField = "ColorTextField"
            ColorList.DataValueField = "ColorValueField"

            ' Bind the data to the control.
            ColorList.DataBind()

            ' Set the default selected item, if desired.
            ColorList.SelectedIndex = 0

         End If

      End Sub

      Function CreateDataSource() As ICollection 
      
         ' Create a table to store data for the DropDownList control.
         Dim dt As DataTable = New DataTable()
         
         ' Define the columns of the table.
         dt.Columns.Add(new DataColumn("ColorTextField", GetType(String)))
         dt.Columns.Add(new DataColumn("ColorValueField", GetType(String)))
 
         ' Populate the table with sample values.
         dt.Rows.Add(CreateRow("White", "White", dt))
         dt.Rows.Add(CreateRow("Silver", "Silver", dt))
         dt.Rows.Add(CreateRow("Dark Gray", "DarkGray", dt))
         dt.Rows.Add(CreateRow("Khaki", "Khaki", dt))
         dt.Rows.Add(CreateRow("Dark Khaki", "DarkKhaki", dt))
 
         ' Create a DataView from the DataTable to act as the data source
         ' for the DropDownList control.
         Dim dv As DataView = New DataView(dt)
         Return dv

      End Function

      Function CreateRow(Text As String, Value As String, dt As DataTable) As DataRow 

         ' Create a DataRow using the DataTable defined in the 
         ' CreateDataSource method.
         Dim dr As DataRow = dt.NewRow()
 
         ' This DataRow contains the ColorTextField and ColorValueField 
         ' fields, as defined in the CreateDataSource method. Set the 
         ' fields with the appropriate value. Remember that column 0 
         ' is defined as ColorTextField, and column 1 is defined as 
         ' ColorValueField.
         dr(0) = Text
         dr(1) = Value
 
         Return dr

      End Function
  
   </script>
  
<body>

   <form runat="server">
  
      <h3> DropDownList Data Binding Example </h3>

      Select a background color for days in the calendar.

      <br><br> 
  
      <asp:Calendar id="Calendar1"
           ShowGridLines="True" 
           ShowTitle="True"
           runat="server"/>

      <br><br>

      <table cellpadding="5">

         <tr>

            <td>

               Background color:

            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="ColorList"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Selection_Change"
                    runat="server"/>

            </td>

         </tr>
  
   </form>

</body>
</html>
 
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<html>
   <script runat="server" >
  
      void Selection_Change(Object sender, EventArgs e)
      {

         // Set the background color for days in the Calendar control
         // based on the value selected by the user from the 
         // DropDownList control.
         Calendar1.DayStyle.BackColor = 
             System.Drawing.Color.FromName(ColorList.SelectedItem.Value);

      }

      void Page_Load(Object sender, EventArgs e)
      {
  
         // Load data for the DropDownList control only once, when the 
         // page is first loaded.
         if(!IsPostBack)
         {

            // Specify the data source and field names for the Text 
            // and Value properties of the items (ListItem objects) 
            // in the DropDownList control.
            ColorList.DataSource = CreateDataSource();
            ColorList.DataTextField = "ColorTextField";
            ColorList.DataValueField = "ColorValueField";

            // Bind the data to the control.
            ColorList.DataBind();

            // Set the default selected item, if desired.
            ColorList.SelectedIndex = 0;

         }

      }

      ICollection CreateDataSource() 
      {
      
         // Create a table to store data for the DropDownList control.
         DataTable dt = new DataTable();
         
         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("ColorTextField", typeof(String)));
         dt.Columns.Add(new DataColumn("ColorValueField", typeof(String)));
 
         // Populate the table with sample values.
         dt.Rows.Add(CreateRow("White", "White", dt));
         dt.Rows.Add(CreateRow("Silver", "Silver", dt));
         dt.Rows.Add(CreateRow("Dark Gray", "DarkGray", dt));
         dt.Rows.Add(CreateRow("Khaki", "Khaki", dt));
         dt.Rows.Add(CreateRow("Dark Khaki", "DarkKhaki", dt));
 
         // Create a DataView from the DataTable to act as the data source
         // for the DropDownList control.
         DataView dv = new DataView(dt);
         return dv;

      }

      DataRow CreateRow(String Text, String Value, DataTable dt)
      {

         // Create a DataRow using the DataTable defined in the 
         // CreateDataSource method.
         DataRow dr = dt.NewRow();
 
         // This DataRow contains the ColorTextField and ColorValueField 
         // fields, as defined in the CreateDataSource method. Set the 
         // fields with the appropriate value. Remember that column 0 
         // is defined as ColorTextField, and column 1 is defined as 
         // ColorValueField.
         dr[0] = Text;
         dr[1] = Value;
 
         return dr;

      }
  
   </script>
  
<body>

   <form runat="server">
  
      <h3> DropDownList Data Binding Example </h3>

      Select a background color for days in the calendar.

      <br><br> 
  
      <asp:Calendar id="Calendar1"
           ShowGridLines="True" 
           ShowTitle="True"
           runat="server"/>

      <br><br>

      <table cellpadding="5">

         <tr>

            <td>

               Background color:

            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="ColorList"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Selection_Change"
                    runat="server"/>

            </td>

         </tr>
  
   </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.DropDownList

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

DropDownList-Member
System.Web.UI.WebControls-Namespace
BorderColor
BorderStyle
BorderWidth
ListItem
System.Collections.ArrayList
Control.DataBind
SelectedIndex