ASP:RADIOBUTTONLIST |
ASP : Liste de bouton radio |
|---|---|
| ASP.NET | |
Syntaxe
|
<asp:RadioButtonList paramètres> <asp:ListItem>valeurs 1</asp:ListItem> <asp:ListItem>valeurs 2</asp:ListItem> <asp:ListItem>valeurs 3</asp:ListItem> ... </asp:RadioButtonList> |
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. | ||
| CellPadding=valeur | Ce paramètre permet d'indiquer l'espace d'empattement d'une cellule. | ||
| CellSpacing=valeur | Ce paramètre permet d'indiquer l'espacement entre les cellules. | ||
| 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. | ||
| RepeatColumns=valeur | Ce paramètre permet d'indiquer le nombre de colonnes par de répétitions. | ||
| RepeatDirection=valeur | Ce paramètre permet d'indiquer la direction de la répétition de colonne : | ||
| Constante | Description | ||
| "Horizontal" | Cette constante permet d'indiquer qu'il faut effectuer la répétition des colonnes dans le sens horizontal. | ||
| "Vertical" | Cette constante permet d'indiquer qu'il faut effectuer la répétition des colonnes dans le sens vertical. | ||
| RepeatLayout=valeur | Ce paramètre permet d'indiquer la couche de la répétition : | ||
| Constante | Description | ||
| "Table" | Cette constante permet d'indiquer une couche en tableau. | ||
| "Flow" | Cette constante permet d'indiquer une couche en flux de données. | ||
| "OrderedList" | Cette constante permet d'indiquer une couche en une liste ordonnée. | ||
| "UnorderedList" | Cette constante permet d'indiquer une couche en une liste désordonnée. | ||
| 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 une liste de contrôle de bouton style radio et comprenant des balises «ASP:LISTITEM».
Remarques
- Le contrôle <asp:RadioButtonList> permet d'afficher un ensemble de boutons radio liés entre eux, tous appartenant automatiquement au même groupe. Cela simplifie grandement la gestion de groupes de choix exclusifs.
- Contrairement aux RadioButton définis individuellement, il n'est pas nécessaire de spécifier un GroupName pour les regrouper. Le RadioButtonList gère automatiquement l'exclusivité entre les options.
- Chaque élément de la liste est défini à l'aide de balises <asp:ListItem>, représentant les différentes valeurs que l'utilisateur peut sélectionner. Chaque item possède ses propres attributs comme Text et Value.
- La propriété SelectedValue permet de récupérer directement la valeur sélectionnée parmi les options. Cela simplifie considérablement le traitement côté serveur, surtout dans les formulaires.
- Le RadioButtonList peut être orienté horizontalement ou verticalement à l'aide de la propriété RepeatDirection, avec les valeurs "Horizontal" ou "Vertical". Cela permet une meilleure adaptation à la mise en page.
- De plus, l'attribut RepeatLayout offre le choix entre un rendu Table, Flow ou OrderedList, ce qui permet de personnaliser la manière dont les boutons sont rendus dans le HTML.
- On peut prédéfinir l'option sélectionnée à l'aide de l'attribut Selected="True" sur un ListItem, ou définir SelectedValue dans le code-behind. Cela permet de proposer une sélection par défaut à l'utilisateur.
- Chaque item peut avoir un Text affiché à l'écran et un Value interne, qui peut être différent. Cela permet d'afficher un libellé utilisateur tout en conservant une valeur technique pour le traitement.
- Le contrôle s'intègre facilement avec les validateurs ASP.NET comme RequiredFieldValidator, garantissant qu'une sélection soit effectuée avant la soumission du formulaire.
- Il est aussi compatible avec la propriété AutoPostBack, permettant de déclencher un postback serveur dès que l'utilisateur change de sélection, utile dans les interfaces interactives.
- La propriété CssClass permet d'appliquer des styles personnalisés au contrôle. On peut également styliser chaque ListItem individuellement en utilisant des gabarits personnalisés.
- Le RadioButtonList est particulièrement utile pour les questions à choix unique dans les formulaires, comme les sondages, les préférences d'abonnement ou les options de configuration.
- Dans le code-behind, la liste des items peut être remplie dynamiquement à partir d'une base de données ou d'une autre source de données, en utilisant la collection Items.Add().
- Ce contrôle est bien adapté à l'internationalisation : les ListItem peuvent contenir du texte localisé, ce qui permet une adaptation facile aux différentes langues de l'interface.
- L'attribut Enabled permet de rendre le contrôle interactif ou non. Lorsqu'il est désactivé, toutes les options deviennent grisées et non sélectionnables, ce qui peut servir à guider l'utilisateur.
Exemple
Voici un exemple permettant d'afficher une liste de boutons radio :
- <%@ 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:RadioButtonList id="RadioButtonListA" 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:RadioButtonList>
- </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