ASP:LISTBOX |
ASP : Liste de boite |
|---|---|
| ASP.NET | |
Syntaxe
|
<asp:ListBox paramètres> <asp:ListItem>valeurs 1</asp:ListItem> <asp:ListItem>valeurs 2</asp:ListItem> <asp:ListItem>valeurs 3</asp:ListItem> ... </asp:ListBox> |
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. | ||
| AutoPostBack=valeur | Ce paramètre permet d'indiquer s'il faut poster immédiatement après avoir sélectionné ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer qu'il ne faut pas poster. | ||
| "True" | Cette constante permet d'indiquer qu'il faut poster. | ||
| 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. | ||
| 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. | ||
| Rows=valeur | Ce paramètre permet d'indiquer le nombre de lignes du contenu. | ||
| 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é. | ||
| SelectionMode=valeur | Ce paramètre permet d'indiquer le mode de sélection : | ||
| Constante | Description | ||
| "Single" | Cette constante permet d'indiquer un mode de sélection simple. | ||
| "Multiple" | Cette constante permet d'indiquer un mode de sélection multiple. | ||
| 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 «ListBox» avec les balises «ASP:LISTITEM».
Remarques
- Le contrôle <asp:ListBox> permet d'afficher une liste de choix dans laquelle l'utilisateur peut sélectionner un ou plusieurs éléments. C'est une composante utile pour des formulaires où plusieurs options sont disponibles.
- Chaque élément de la liste est défini à l'aide de la balise <asp:ListItem>, avec un texte visible et éventuellement une valeur différente pour le traitement côté serveur (Text et Value).
- Par défaut, la ListBox ne permet qu'une seule sélection, mais on peut activer la sélection multiple en définissant la propriété SelectionMode="Multiple".
- Ce contrôle est souvent utilisé lorsque les options sont trop nombreuses pour un DropDownList, ou lorsqu'on souhaite permettre plusieurs sélections en une seule interaction utilisateur.
- La liste peut être peuplée dynamiquement dans le code-behind à l'aide de la méthode Items.Add() ou via la liaison à une source de données comme une base de données ou une collection.
- La propriété Rows permet de définir le nombre de lignes visibles à l'écran. Cela permet d'adapter la taille du composant à la longueur prévue de la liste.
- Une ListBox avec SelectionMode="Multiple" oblige souvent à combiner des touches clavier (Ctrl ou Shift) pour sélectionner plusieurs éléments, ce qui doit être pris en compte en termes d'ergonomie.
- On peut récupérer les éléments sélectionnés dans le code serveur via la propriété SelectedItems, ce qui est pratique pour traiter des listes de valeurs sélectionnées.
- La propriété AutoPostBack="true" permet de déclencher un postback dès qu'un élément est sélectionné, utile si l'on veut modifier l'interface immédiatement après un choix.
- Il est possible de grouper logiquement les valeurs en ajoutant un texte explicatif ou en ajoutant dynamiquement des séparateurs visuels, bien que ce ne soit pas directement prévu dans la structure du contrôle.
- Le ListBox peut être stylisé avec des classes CSS (CssClass) pour modifier son apparence (bordure, couleurs, survol,...), ce qui est essentiel pour l'intégrer dans une charte graphique spécifique.
- Pour des raisons d'accessibilité, il est important d'associer une étiquette (<asp:Label> ou <label for="">) à la ListBox, afin d'informer clairement l'utilisateur sur son utilité.
- La gestion des sélections multiples doit être pensée côté serveur avec soin, surtout si la liste contient beaucoup d'éléments. Il faut veiller à valider les données pour éviter des sélections non souhaitées.
- Le contrôle peut être vidé (Items.Clear()) ou mis à jour à la volée selon les interactions de l'utilisateur, permettant par exemple des listes dépendantes dans des interfaces avancées.
- L'ordre des éléments peut être important : il est parfois judicieux de trier les éléments ou de les organiser en fonction de la fréquence d'utilisation ou d'un ordre logique.
Exemple
Voici un exemple permettant d'afficher une liste de sélection :
- <%@ 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:ListBox id="ListBox1" 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:ListBox>
- </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