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

RadioButtonList, classe

Mise à jour : novembre 2007

Représente un contrôle de liste qui encapsule un groupe de contrôles de cases d'option.

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

[ValidationPropertyAttribute("SelectedItem")]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class RadioButtonList : ListControl, 
	IRepeatInfoUser, INamingContainer, IPostBackDataHandler
/** @attribute ValidationPropertyAttribute("SelectedItem") */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class RadioButtonList extends ListControl implements IRepeatInfoUser, 
	INamingContainer, IPostBackDataHandler
public class RadioButtonList extends ListControl implements IRepeatInfoUser, INamingContainer, IPostBackDataHandler
<asp:RadioButtonList />

Le contrôle RadioButtonList propose aux développeurs de pages un groupe de cases d'option à une seule sélection pouvant être généré dynamiquement grâce à une liaison de données. Il comporte une collection Items dont les membres correspondent à chacun des éléments figurant dans la liste. Pour déterminer l'élément sélectionné, testez la propriété SelectedItem de la liste.

Vous pouvez spécifier la restitution de la liste à l'aide des propriétés RepeatLayout et RepeatDirection. Si RepeatLayout a la valeur RepeatLayout.Table (paramètre par défaut), la liste est alors restituée dans un tableau. S'il a la valeur RepeatLayout.Flow, la liste est alors restituée sans structure tabulaire. RepeatDirection a la valeur par défaut RepeatDirection.Vertical. Lorsque vous affectez RepeatDirection.Horizontal à cette propriété, la liste est restituée horizontalement.

Attention :

Ce contrôle peut être utilisé pour afficher des entrées d'utilisateur qui peuvent 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. Vous pouvez utiliser les contrôles de validation pour vérifier les entrées d'utilisateur avant d'afficher le texte d'entrée dans un contrôle RadioButtonList. 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. Pour plus d'informations, consultez Sécurisation de contrôles standard, Comment : se protéger contre les attaques de script dans une application Web en utilisant le codage HTML et Validation des entrées d'utilisateur dans des pages Web ASP.NET.

Accessibilité

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

TopicLocation
Comment : définir la sélection dans un contrôle serveur Web List (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 Web ASP.NET dans Visual Studio
Comment : remplir des contrôles serveur Web List à partir d'une source de données (Visual Studio)Gé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 éléments dans des contrôles serveur Web List (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 sélection dans un contrôle serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des modifications dans des contrôles serveur Web ListGé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 : ajouter des contrôles à une page Web ASP.NET par programmeGénération d'applications Web ASP.NET dans Visual Studio
Comment : remplir des contrôles serveur Web List à partir d'une source de données (Visual Studio)Gé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 éléments dans des contrôles serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : déterminer la sélection dans un contrôle serveur Web ListGé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 à des modifications dans des contrôles serveur Web ListGénération d'applications Web ASP.NET
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 : déterminer la sélection dans un contrôle serveur Web ListGénération d'applications Web ASP.NET
Comment : définir la sélection dans un contrôle serveur Web ListGénération d'applications Web ASP.NET
Comment : ajouter des éléments dans des contrôles serveur Web ListGénération d'applications Web ASP.NET
Comment : ajouter des contrôles à une page Web ASP.NET par programmeGé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 : remplir des contrôles serveur Web List à partir d'une source de donnéesGénération d'applications Web ASP.NET
Comment : définir la sélection dans un contrôle serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à des modifications dans des contrôles serveur Web ListGé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 : ajouter des contrôles à une page Web ASP.NET par programmeGénération d'applications Web ASP.NET dans Visual Studio
Comment : remplir des contrôles serveur Web List à partir d'une source de données (Visual Studio)Gé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 éléments dans des contrôles serveur Web List (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : déterminer la sélection dans un contrôle serveur Web ListGé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

L'exemple de code suivant illustre la modification par programme de l'affichage d'un contrôle RadioButtonList.

Remarque :

L'exemple de code suivant utilise un modèle de code de fichier unique ; il est possible qu'il ne fonctionne pas correctement s'il est directement copié dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide doté d'une extension .aspx. Pour plus d'informations sur le modèle de code Web Forms, consultez Modèle de code des pages Web ASP.NET.

<%@ Page Language="C#" AutoEventWireup="True" %>
<!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" >
 <head>
    <title>RadioButtonList Example</title>
<script language="C#" runat="server">

        void Button1_Click(object Source, EventArgs e) 
        {
           if (RadioButtonList1.SelectedIndex > -1) 
           {  
              Label1.Text = "You selected: " + RadioButtonList1.SelectedItem.Text;
           }
        }

        void chkLayout_CheckedChanged(Object sender, EventArgs e) 
        {

           if (chkLayout.Checked == true) 
           {
              RadioButtonList1.RepeatLayout = RepeatLayout.Table;
           }
           else 
           {
              RadioButtonList1.RepeatLayout = RepeatLayout.Flow;
           }     
        }

        void chkDirection_CheckedChanged(Object sender, EventArgs e) 
        {

           if (chkDirection.Checked == true) 
           {
              RadioButtonList1.RepeatDirection = RepeatDirection.Horizontal;
           }
           else 
           {
              RadioButtonList1.RepeatDirection = RepeatDirection.Vertical;
           }  
        }

     </script>

 </head>
 <body>

     <h3>RadioButtonList Example</h3>

     <form id="form1" runat="server">

         <asp:RadioButtonList id="RadioButtonList1" 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:ListItem>Item 6</asp:ListItem>
         </asp:RadioButtonList>

         <br />

         <asp:CheckBox id="chkLayout" OnCheckedChanged="chkLayout_CheckedChanged" Text="Display Table Layout" Checked="true" AutoPostBack="true" runat="server" />

         <br />

         <asp:CheckBox id="chkDirection" OnCheckedChanged="chkDirection_CheckedChanged" Text="Display Horizontally" AutoPostBack="true" runat="server" />

         <br />

         <asp:Button id="Button1" Text="Submit" onclick="Button1_Click" runat="server"/>

         <br />

         <asp:Label id="Label1" font-names="Verdana" font-size="8pt" runat="server"/>

     </form>

 </body>
 </html>



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

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

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0
Afficher: