ASP:DROPDOWNLIST |
ASP : Liste de menu déroulant |
|---|---|
| ASP.NET | |
Syntaxe
|
<asp:DropDownList paramètres> <asp:ListItem>valeurs 1</asp:ListItem> <asp:ListItem>valeurs 2</asp:ListItem> <asp:ListItem>valeurs 3</asp:ListItem> ... </asp:DropDownList> |
Paramètres
| Paramètre | Description | ||
|---|---|---|---|
| AccessKey=valeur | Ce paramètre de balise permet d'indiquer un touche de raccourci à associer avec cette balise. | ||
| AppendDataBoundItems=valeur | Ce paramètre permet d'indiquer si les éléments de la liste sont effacés avant la liaison des données ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer qu'ils ne sont pas effacés. | ||
| "True" | Cette constante permet d'indiquer qu'ils sont effacés. | ||
| BackColor=valeur | Ce paramètre permet d'indiquer la couleur d'arrière plan de la balise. | ||
| BorderColor=valeur | Ce paramètre permet d'indiquer la couleur de bordure de la balise. | ||
| BorderStyle=valeur | Ce paramètre permet d'indiquer le style de bordure de la balise : NotSet, None, Dotted, Dashed, Solid, Double, Groove, Ridge, Inset ou Outset. | ||
| BorderWidth=valeur | Ce paramètre permet d'indiquer la largeur de la bordure de la balise. | ||
| CausesValidation=valeur | Ce paramètre permet d'indiquer s'il faut effectuer la validation ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer qu'il ne faut pas valider. | ||
| "True" | Cette constante permet d'indiquer qu'il faut valider. | ||
| CssClass=valeur | Ce paramètre permet d'indiquer la classe de feuille de style CSS de la balise. | ||
| DataMember=valeur | Ce paramètre permet d'indiquer les données du membre de la balise. | ||
| DataSource=valeur | Ce paramètre permet d'indiquer le contrôle où sont situés les données. | ||
| DataSourceID=valeur | Ce paramètre permet d'indiquer l'identificateur de contrôle où sont situés les données. | ||
| DataTextField=valeur | Ce paramètre permet d'indiquer le champ de données texte. | ||
| DataTextFormatString=valeur | Ce paramètre permet d'indiquer la chaine de caractères de formatage du champ de données texte. | ||
| DataValueField=valeur | Ce paramètre permet d'indiquer la valeur du champ de données. | ||
| Enabled=valeur | Ce paramètre permet d'indiquer si la balise doit être active ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la balise n'est pas active. | ||
| "True" | Cette constante permet d'indiquer que la balise n'est pas active. | ||
| EnableTheming=valeur | Ce paramètre permet d'indiquer si le thème de la balise doit être affiché ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que le thème de la balise n'est pas affiché. | ||
| "True" | Cette constante permet d'indiquer que le thème de la balise est affiché. | ||
| EnableViewState=valeur | Ce paramètre permet d'indiquer si le ViewState de la balise doit être activé ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que le ViewState de la balise n'est pas actif. | ||
| "True" | Cette constante permet d'indiquer que le ViewState de la balise est actif. | ||
| Font-Bold=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être en gras ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas en gras. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est en gras. | ||
| Font-Italic=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être en italique ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas en italique. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est en italique. | ||
| Font-Names=valeur | Ce paramètre permet d'indiquer les noms de la police de caractères. | ||
| Font-Overline=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être surligné ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas surligné. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est surligné. | ||
| Font-Size=valeur | Ce paramètre permet d'indiquer la taille de la police de caractères de la balise : Smaller, Larger, XX-Small, X-Small, Small, Medium, Large, X-Large ou XX-Large. | ||
| Font-Strikeout=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être barré ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas barré. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est barré. | ||
| Font-Underline=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être souligné ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas souligné. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est souligné. | ||
| ForeColor=valeur | Ce paramètre permet d'indiquer la couleur de premier plan de la balise. | ||
| Height=valeur | Ce paramètre permet d'indiquer la hauteur de la balise. | ||
| ID=valeur | Ce paramètre permet d'indiquer l'identificateur de la balise. | ||
| OnDataBinding=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de DataBinding. | ||
| OnDataBound=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de DataBound. | ||
| OnDisposed=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de disposition. | ||
| OnInit=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement d'initialisation. | ||
| OnLoad=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de chargement. | ||
| OnPreRender=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de pré-rendu. | ||
| OnSelectedIndexChanged=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de changement d'index sélectionné. | ||
| OnTextChanged=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de changement de texte. | ||
| OnUnload=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de déchargement. | ||
| runat=valeur | Ce paramètre permet d'indiquer où doit être exécuté la balise : | ||
| Constante | Description | ||
| "server" | Cette constante permet d'indiquer qu'il faut exécuter la balise du côté serveur. | ||
| SelectedIndex=valeur | Ce paramètre permet d'indiquer la position d'index sélectionné. | ||
| SelectedValue=valeur | Ce paramètre permet d'indiquer la valeur sélectionné. | ||
| SkinID=valeur | Ce paramètre permet d'indiquer l'identificateur de Skin. | ||
| Style=valeur | Ce paramètre de balise permet d'indiquer des paramètres de feuille de style associé avec cette balise. | ||
| TabIndex=valeur | Ce paramètre de balise permet d'indiquer l'ordre de sélection des champs et éléments dans un formulaire. | ||
| ToolTip=valeur | Ce paramètre de balise permet d'indiquer l'info-bulle. | ||
| ValidationGroup=valeur | Ce paramètre de balise permet d'indiquer le groupe de validation. | ||
| Visible=valeur | Ce paramètre permet d'indiquer si la balise doit être affiché ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la balise n'est pas affiché. | ||
| "True" | Cette constante permet d'indiquer que la balise est affiché. | ||
| Width=valeur | Ce paramètre de balise permet d'indiquer la largeur de la balise. | ||
Description
Cette balise permet de définir un contrôle de choix de réponse comprenant des balises «ASP:LISTITEM».
Remarques
- Le contrôle <asp:DropDownList> permet d'afficher une liste déroulante dans laquelle l'utilisateur peut sélectionner une seule valeur parmi plusieurs. C'est une composante idéal pour les sélections uniques comme les pays, les catégories ou les niveaux d'accès.
- Chaque option de la liste est représentée par un élément <asp:ListItem>, disposant d'un texte visible (Text) et d'une valeur associée (Value). Cette séparation permet d'afficher une information lisible à l'utilisateur tout en traitant des données techniques côté serveur.
- La propriété SelectedItem permet d'accéder à l'élément actuellement sélectionné dans la liste. On peut également utiliser SelectedValue pour obtenir directement la valeur associée, ce qui est pratique pour le traitement des formulaires.
- Le contrôle peut être alimenté manuellement en définissant les ListItem dans le balisage, ou dynamiquement à partir d'une source de données (DataSource) avec la méthode DataBind(). Cela permet de remplir la liste avec des données provenant d'une base ou d'une API.
- L'attribut ID est indispensable pour identifier le contrôle côté serveur. Il permet de le manipuler en C# ou VB.NET, que ce soit pour lire la sélection, définir un élément par défaut, ou réagir à un événement utilisateur.
- Le paramètre runat="server" est requis pour que le contrôle soit géré côté serveur. Cela permet d'interagir avec son contenu dans le code-behind et d'en exploiter les fonctionnalités ASP.NET comme le ViewState.
- On peut définir une valeur sélectionnée par défaut en ajoutant Selected="True" à l'un des éléments <asp:ListItem>, ou en définissant la propriété SelectedValue dans le code serveur avant le DataBind.
- La propriété AutoPostBack="true" permet d'exécuter un postback immédiatement après un changement de sélection. Cela est utile pour afficher dynamiquement des informations en fonction du choix effectué dans la liste.
- Le contrôle déclenche l'événement SelectedIndexChanged lorsque l'utilisateur change d'élément. Cet événement permet de déclencher du code serveur pour adapter l'interface, effectuer un filtrage ou modifier d'autres champs.
- Le DropDownList est compatible avec le ViewState, ce qui signifie que la sélection de l'utilisateur est conservée automatiquement entre les postbacks sans intervention du développeur.
- Pour améliorer l'expérience utilisateur, il est conseillé d'ajouter un élément vide ou neutre en première position, comme -- Sélectionner --, afin de forcer l'utilisateur à faire un choix explicite et éviter une sélection par défaut non intentionnelle.
- Visuellement, le contrôle peut être personnalisé avec des propriétés comme CssClass, Width, Font, ou encore des styles CSS appliqués dynamiquement. Cela permet de l'intégrer harmonieusement dans l'interface graphique du site.
- On peut désactiver le contrôle à l'aide de la propriété Enabled="false" pour afficher une liste non modifiable, par exemple lorsque l'option dépend d'une condition ou d'un rôle utilisateur.
- Il est possible de manipuler les éléments de la liste à l'aide de méthodes comme Items.Add(), Items.Remove(), ou Items.Clear() dans le code serveur. Cela offre un grand contrôle sur la composition de la liste à chaque étape du cycle de vie de la page.
- Le contrôle DropDownList s'intègre facilement dans des structures plus complexes comme un GridView, un FormView, ou des UpdatePanel pour une mise à jour partielle sans rechargement complet de la page.
Exemple
Voici un exemple permettant d'afficher un choix en 5 items :
- <%@ Page Language="vb" %>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
- <html xmlns="http://www.w3.org/1999/xhtml">
- <body>
- <form id="MonFormulaire" runat="server">
- <asp:DropDownList id="DropDownListA" 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:DropDownList>
- </form>
- </body>
- </html>
on obtiendra le résultat semblable suivant :
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Samedi, le 31 août 2017