Cette documentation est archivée et n’est pas conservée.

RadioButton, classe

Représente un contrôle de case d'option.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public class RadioButton : CheckBox, IPostBackDataHandler
public class RadioButton extends CheckBox implements IPostBackDataHandler
public class RadioButton extends CheckBox implements IPostBackDataHandler

Le contrôle serveur RadioButton vous permet d'intercaler des cases d'option dans un groupe au contenu différent dans la page. Les boutons sont regroupés d'un point de vue logique s'ils partagent tous la même propriété GroupName.

RemarqueRemarque

Vous pouvez utiliser le contrôle RadioButton pour afficher les entrées d'utilisateur pouvant inclure un script client malveillant. Recherchez dans toutes les informations envoyées par un client un script exécutable, des instructions SQL ou d'autre code avant de les afficher dans votre application. ASP.NET fournit une fonctionnalité de validation de demande d'entrée pour bloquer les scripts et le HTML dans les entrées d'utilisateur. Des contrôles serveur de validation sont également fournis pour valider les entrées d'utilisateur. Pour plus d'informations, consultez Syntaxe des contrôles serveur de validation.

Accessibilité

Le balisage rendu par défaut pour ce contrôle peut ne pas se conformer aux normes d'accessibilité telles que les instructions de priorité 1 d'accessibilité du contenu Web (WCAG, Web Content Accessibility Guidelines). Pour plus d'informations sur la prise en charge d'accessibilité pour ce contrôle, consultez Contrôles et accessibilité ASP.NET.

RubriqueEmplacement
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : utilisation de styles de feuille de style en cascade dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web RadioButtonList à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web RadioButton à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création et utilisation de pages maîtres ASP.NET dans Visual Web DeveloperGénération d'applications à l'aide de Visual Web Developer
Comment : définir la disposition dans un contrôle serveur Web RadioButtonListGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir et récupérer la sélection dans un contrôle serveur Web RadioButtonGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web RadioButtonList à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web RadioButton à une page Web FormsGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à la sélection d'un utilisateur dans un groupe de contrôles serveur Web RadioButtonGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir la disposition dans un contrôle serveur Web RadioButtonListGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir et récupérer la sélection dans un contrôle serveur Web RadioButtonGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web RadioButtonList à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : liaison de données à un objet métier personnaliséGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web RadioButton à une page Web FormsGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à la sélection d'un utilisateur dans un groupe de contrôles serveur Web RadioButtonGénération d'applications Web ASP.NET dans Visual Studio
Comment : définir la disposition dans un contrôle serveur Web RadioButtonListGénération d'applications Web ASP.NET
Comment : définir et récupérer la sélection dans un contrôle serveur Web RadioButtonGénération d'applications Web ASP.NET
Comment : ajouter des contrôles serveur Web RadioButtonList à une page Web FormsGénération d'applications Web ASP.NET
Comment : ajouter des contrôles serveur Web RadioButton individuels à une page Web FormsGénération d'applications Web ASP.NET
Comment : définir le focus sur des contrôles serveur Web ASP.NETGénération d'applications Web ASP.NET
Comment : répondre à la sélection d'un utilisateur dans un groupe de contrôles serveur Web RadioButtonGénération d'applications Web ASP.NET

L'exemple de code suivant illustre l'utilisation du contrôle RadioButton.

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
 <head>
 
     <script language="C#" runat="server">
 
         void SubmitBtn_Click(Object Sender, EventArgs e) {
         
             if (Radio1.Checked) {
                 Label1.Text = "You selected " + Radio1.Text;
             }
             else if (Radio2.Checked) {
                 Label1.Text = "You selected " + Radio2.Text;
             }
             else if (Radio3.Checked) {
                 Label1.Text = "You selected " + Radio3.Text;
             }
         }
 
     </script>
 
 </head>
 <body>
 
     <h3>RadioButton Example</h3>
 
     <form runat=server>
     
         <h4>Select the type of installation you want to perform:</h4>
     
         <asp:RadioButton id=Radio1 Text="Typical" Checked="True" GroupName="RadioGroup1" runat="server" /><br>
         
         This option installs the features most typically used.  <i>Requires 1.2 MB disk space.</i><p>
             
         <asp:RadioButton id=Radio2 Text="Compact" GroupName="RadioGroup1" runat="server"/><br>
         
         This option installs the minimum files required to run the product.  <i>Requires 350 KB disk space.</i><p>
          
         <asp:RadioButton id=Radio3 runat="server" Text="Full" GroupName="RadioGroup1" /><br>
         
         This option installs all features for the product.  <i>Requires 4.3 MB disk space.</i><p>
 
         <asp:button text="Submit" OnClick="SubmitBtn_Click" runat=server/>
 
         <asp:Label id=Label1 font-bold="true" runat="server" />
             
     </form>
 
 </body>
 </html>
 

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
       System.Web.UI.WebControls.CheckBox
        System.Web.UI.WebControls.RadioButton

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0
Afficher: