Exporter (0) Imprimer
Développer tout

DropDownList, classe

Représente un contrôle qui permet à l'utilisateur de sélectionner un seul élément dans une liste déroulante.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

[ValidationPropertyAttribute("SelectedItem")] 
public class DropDownList : ListControl, IPostBackDataHandler
/** @attribute ValidationPropertyAttribute("SelectedItem") */ 
public class DropDownList extends ListControl implements IPostBackDataHandler
ValidationPropertyAttribute("SelectedItem") 
public class DropDownList extends ListControl implements IPostBackDataHandler

Utilisez le contrôle DropDownList pour créer un contrôle de liste déroulante à sélection unique. Vous pouvez contrôler l'aspect du contrôle DropDownList en définissant les propriétés BorderColor, BorderStyle et BorderWidth.

Pour spécifier les éléments que vous souhaitez afficher dans le contrôle DropDownList, placez un objet ListItem pour chaque entrée entre les balises d'ouverture et de fermeture du contrôle DropDownList.

Le contrôle DropDownList prend également en charge la liaison de données. Pour lier le contrôle à une source de données, créez une source de données, telle qu'un objet System.Collections.ArrayList, qui contient les éléments à afficher dans le contrôle. Utilisez ensuite la méthode Control.DataBind pour lier la source de données au contrôle DropDownList.

Utilisez la propriété SelectedIndex pour déterminer par programme l'index de l'élément sélectionné par l'utilisateur dans le contrôle DropDownList.

Accessibilité

Le balisage rendu par défaut pour ce contrôle peut ne pas se conformer aux normes d'accessibilité telles que les instructions de priorité 1 d'accessibilité du contenu Web (WCAG, Web Content Accessibility Guidelines). Pour plus d'informations sur la prise en charge d'accessibilité pour ce contrôle, consultez Contrôles et accessibilité ASP.NET.

RubriqueEmplacement
Comment : définir la sélection dans un contrôle serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web DropDownList à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage des données mises en forme dans les pages Web avec le contrôle serveur Web FormViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : remplir des contrôles serveur Web List à partir d'une source de données (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web pour afficher des données XMLGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'un document XML dans une page Web Forms à l'aide des transformationsGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'une liste déroulante tout en modifiant le contrôle serveur Web GridViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des éléments dans des contrôles serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création de pages Web maître/détail dans Visual StudioGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : affichage d'une liste déroulante tout en modifiant le contrôle serveur Web GridViewGénération d'applications à l'aide de Visual Web Developer
Procédure pas à pas : création de pages Web maître/détail dans Visual StudioGénération d'applications à l'aide de Visual Web Developer
Comment : ajouter des contrôles serveur Web DropDownList à une page Web FormsGénération d'applications Web ASP.NET
Comment : répondre à des modifications dans des contrôles serveur Web ListGénération d'applications Web ASP.NET
Comment : définir la sélection dans un contrôle serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des modifications dans des contrôles serveur Web ListGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web DropDownList à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage des données mises en forme dans les pages Web avec le contrôle serveur Web FormViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : remplir des contrôles serveur Web List à partir d'une source de données (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web pour afficher des données XMLGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des éléments dans des contrôles serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : déterminer la sélection dans un contrôle serveur Web ListGénération d'applications Web ASP.NET dans Visual Studio
Comment : afficher des données sitemap dans des contrôles serveur Web non hiérarchiquesGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'un document XML dans une page Web Forms à l'aide des transformationsGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir la sélection dans un contrôle serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des modifications dans des contrôles serveur Web ListGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web DropDownList à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage des données mises en forme dans les pages Web avec le contrôle serveur Web FormViewGénération d'applications Web ASP.NET dans Visual Studio
Comment : remplir des contrôles serveur Web List à partir d'une source de données (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'une page Web pour afficher des données XMLGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'une liste déroulante tout en modifiant le contrôle serveur Web GridViewdv_vwdcon
Comment : ajouter des éléments dans des contrôles serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : déterminer la sélection dans un contrôle serveur Web ListGénération d'applications Web ASP.NET dans Visual Studio
Comment : afficher des données sitemap dans des contrôles serveur Web non hiérarchiquesGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage d'un document XML dans une page Web Forms à l'aide des transformationsGénération d'applications Web ASP.NET dans Visual Studio
Comment : déterminer la sélection dans un contrôle serveur Web ListGénération d'applications Web ASP.NET
Comment : définir la sélection dans un contrôle serveur Web ListGénération d'applications Web ASP.NET
Comment : ajouter des éléments dans des contrôles serveur Web ListGénération d'applications Web ASP.NET
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET
Comment : remplir des contrôles serveur Web List à partir d'une source de donnéesGénération d'applications Web ASP.NET
Comment : afficher des données sitemap dans des contrôles serveur Web non hiérarchiquesGénération d'applications Web ASP.NET

L'exemple de code suivant illustre la création d'un contrôle DropDownList qui contient quatre éléments.

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

L'exemple de code suivant illustre la création d'un contrôle DropDownList via la liaison de données.

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

  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft