ASP:RADIOBUTTON |
ASP : Bouton radio |
|---|---|
| ASP.NET | |
Syntaxe
|
<asp:RadioButton paramètres> </asp:RadioButton> |
Paramètres
| Paramètre | Description | ||
|---|---|---|---|
| AccessKey=valeur | Ce paramètre de balise permet d'indiquer un touche de raccourci à associer avec cette balise. | ||
| AutoPostBack=valeur | Ce paramètre permet d'indiquer s'il faut poster immédiatement après avoir sélectionné ce bouton radio 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. | ||
| Checked=valeur | Ce paramètre permet d'indiquer si la case est coché ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la case n'est pas coché. | ||
| "True" | Cette constante permet d'indiquer que la case est coché. | ||
| 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. | ||
| GroupName=valeur | Ce paramètre permet d'indiquer le nom du groupe. | ||
| 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. | ||
| OnCheckedChanged=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement lorsque l'état du bouton radio a changé. | ||
| OnDataBinding=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de DataBinding. | ||
| 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. | ||
| 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. | ||
| 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. | ||
| Text=valeur | Ce paramètre de balise permet d'indiquer le texte à côté de la case à cocher. | ||
| TextAlign=valeur | Ce paramètre de balise permet d'indiquer l'alignement du texte à côté de la case à cocher. | ||
| Constante | Description | ||
| "Left" | Cette constante permet d'indiquer que l'alignement s'effectue à gauche. | ||
| "Right" | Cette constante permet d'indiquer que l'alignement s'effectue à droite. | ||
| 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 bouton de style radio.
Remarques
- Le contrôle <asp:RadioButton> permet de créer un bouton radio côté serveur, c'est-à-dire un bouton à sélection unique dans un groupe. Il est utilisé pour proposer à l'utilisateur un choix exclusif parmi plusieurs options.
- Chaque RadioButton fonctionne de manière indépendante sauf si on les regroupe via l'attribut GroupName. Les boutons ayant le même GroupName appartiennent au même groupe logique et se comportent comme des options exclusives.
- Le bouton radio génère du code HTML correspondant à une balise <input type="radio">. La gestion côté serveur permet de lire et modifier son état directement dans le code-behind ASP.NET.
- La propriété Checked permet de déterminer si le bouton est actuellement sélectionné. Elle est particulièrement utile lors du traitement d'un formulaire pour identifier la sélection de l'utilisateur.
- L'attribut Text permet d'associer une étiquette descriptive à un bouton radio. Ce texte est visible à côté du bouton, ce qui améliore l'accessibilité et la clarté de l'interface utilisateur.
- La propriété AutoPostBack, lorsqu'elle est définie sur True, permet au RadioButton d'envoyer immédiatement une requête au serveur dès qu'il est sélectionné. C'est utile pour des interactions en temps réel.
- Un RadioButton peut être stylisé avec des classes CSS, en utilisant l'attribut CssClass, permettant d'intégrer harmonieusement le bouton dans l'esthétique générale du site.
- La gestion des événements du RadioButton, comme OnCheckedChanged, permet de réagir au changement de sélection et d'exécuter du code côté serveur dès que l'utilisateur interagit avec l'élément.
- Dans les formulaires ASP.NET, les RadioButton sont souvent utilisés pour des choix simples tels que "Oui/Non", "Homme/Femme/Autre", ou la sélection d'une option de livraison ou de paiement.
- Contrairement au CheckBox, le RadioButton ne peut être sélectionné que s'il ne l'est pas déjà, et en sélectionnant un autre bouton du même groupe, le précédent se désélectionne automatiquement.
- Les boutons radio ASP.NET ne nécessitent pas forcément de balise fermante ; ils peuvent être auto-fermés, ce qui allège légèrement le code, bien que cela ne change pas leur comportement.
- Le contrôle permet une bonne intégration avec le système de validation ASP.NET. On peut par exemple forcer la sélection d'un bouton via un RequiredFieldValidator lié au groupe de boutons radio.
- Les RadioButton ASP.NET peuvent être désactivés via la propriété Enabled="False", rendant leur interface visible mais inactive, ce qui est utile pour afficher des options sans permettre leur sélection.
- On peut définir un bouton comme sélectionné par défaut en définissant la propriété Checked="True" dans le code HTML ou dans le code-behind lors de l'initialisation de la page.
- Dans des interfaces dynamiques, il est possible de créer et d'ajouter plusieurs RadioButton à la volée à partir de données issues d'une base, en les regroupant logiquement via le GroupName.
Exemple
Voici un exemple permettant d'afficher 3 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:RadioButton id="RadioButton1" runat="server" text="Bouton radio 1" GroupName="MonGroupe"></asp:RadioButton>
- <asp:RadioButton id="RadioButton2" runat="server" text="Bouton radio 2" GroupName="MonGroupe"></asp:RadioButton>
- <asp:RadioButton id="RadioButton3" runat="server" text="Bouton radio 3" GroupName="MonGroupe"></asp:RadioButton>
- </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