Vue d'ensemble du contrôle serveur Web DropDownList

Article
10/22/2014

Mise à jour : novembre 2007

Le contrôle serveur Web DropDownList permet aux utilisateurs d'effectuer une sélection d'un élément à partir d'une zone de liste déroulante.

Cette rubrique contient les sections suivantes :

Fonctionnalités
Arrière-plan
Exemples de code
Référence de classe
Ressources supplémentaires

Fonctionnalités

Vous pouvez utiliser le contrôle DropDownList pour :

Définir la taille du contrôle en pixels.
Utiliser la liaison de données pour spécifier la liste des éléments à afficher.
Déterminer quel élément est sélectionné.
Spécifier l'élément sélectionné par programme.

Retour au début

Arrière-plan

Le contrôle serveur Web DropDownList permet aux utilisateurs de sélectionner un élément dans une liste prédéfinie. Il diffère du contrôle serveur Web ListBox par le fait que la liste des éléments reste masquée jusqu'à ce que l'utilisateur clique sur le bouton de déroulement. De plus, le contrôle DropDownList ne prend pas en charge le mode de multi-sélection.

Modification de l'apparence du contrôle DropDownList

Vous pouvez gérer l'apparence du contrôle DropDownList en définissant sa hauteur et sa largeur en pixels. Certains navigateurs ne prennent pas en charge la définition de la hauteur et de la largeur en pixels et utilisent plutôt le nombre de lignes comme paramètre.

Vous ne pouvez pas spécifier le nombre d'éléments affichés dans la liste lorsque l'utilisateur clique sur le bouton de déroulement. La longueur de la liste affichée est déterminée par le navigateur.

Tout comme avec d'autres contrôles serveur Web, vous pouvez utiliser des objets style pour spécifier l'apparence du contrôle DropDownList. Pour plus d'informations, consultez Contrôles serveur Web ASP.NET et styles CSS.

Éléments de liste

Le contrôle DropDownList est un conteneur pour les éléments de liste qui sont de type ListItem. Chaque objet ListItem dispose de propriétés spécifiques. Ces propriétés sont décrites dans le tableau ci-après.

Propriété	Description
Text	Spécifie le texte affiché dans la liste.
Value	Contient la valeur associée à un élément. Si vous définissez cette propriété, vous pouvez associer une valeur à un élément spécifique sans l'afficher. Par exemple, la propriété Text peut avoir pour valeur le nom d'une couleur et la propriété Value sa représentation hexadécimale.
Selected	Indique si l'élément est actuellement sélectionné.

Pour travailler par programme avec les éléments de liste, utilisez la collection Items du contrôle DropDownList. La collection Items est une collection standard dans laquelle vous pouvez ajouter des objets élément, supprimer des éléments, effacer la collection, etc.

L'élément actuellement sélectionné est disponible dans la propriété SelectedItem du contrôle DropDownList.

Liaison de données au contrôle

Vous pouvez utiliser un contrôle serveur Web DropDownList pour énumérer les options disponibles sur la page à l'aide d'un contrôle de source de données. Chaque élément du contrôle DropDownList correspond à un élément de la source de données, généralement un enregistrement individuel de données.

Le contrôle affiche un champ de la source. Vous pouvez, en option, lier le contrôle à un deuxième champ afin de définir la valeur d'un élément (qui n'est pas affichée).

Tout comme avec d'autres contrôles serveur Web, vous pouvez lier aux données les propriétés d'un contrôle, telles que la couleur ou la taille du contrôle. Pour plus d'informations, consultez Comment : remplir des contrôles serveur Web List à partir d'une source de données.

Événements DropDownList

Le contrôle DropDownList déclenche l'événement SelectedIndexChanged lorsque l'utilisateur sélectionne un élément. Par défaut, cet événement ne provoque pas la publication de la page sur le serveur. Toutefois, vous pouvez provoquer que le contrôle force une publication immédiate en définissant la propriété AutoPostBack à true.

Remarque :
La fonction de publication (postback) automatique exige que le navigateur prenne en charge ECMAScript (JScript ou JavaScript) et que les scripts soient activés sur le navigateur de l'utilisateur.