RadioButtonList, contrôle

Le contrôle RadioButtonList représente un contrôle de liste qui encapsule un groupe de contrôles de cases d’option.

Vous pouvez utiliser deux types de contrôles ASP.NET pour ajouter des cases d’option à une page : des contrôles individuels RadioButton ou un contrôle RadioButtonList. Ces deux contrôles permettent aux utilisateurs de faire une sélection dans une courte série de choix prédéfinis qui s’excluent mutuellement. Les contrôles vous permettent de définir un certain nombre de cases d’option avec des étiquettes et de les disposer horizontalement ou verticalement.

Pour ajouter un contrôle RadioButtonList à une page

• Faites glisser le contrôle RadioButtonList du volet des tâches Boîte à outils sur votre page.

Pour lier le contrôle RadioButtonList à une source de données

1. En mode Création, cliquez avec le bouton droit sur le contrôle RadioButtonList, puis cliquez sur Afficherles tâches de contrôle courantes.

2. Dans le menu Tâches courantes du contrôle RadioButtonList, cliquez sur Choisir une source de données.

3. Dans l’Assistant Configuration de source de données, choisissez une source pour le contrôle RadioButtonList dans la liste déroulante Sélectionner une source de données. Dans la liste déroulante Sélectionner un champ de donnéesà afficherdans RadioButtonList, sélectionnez le champ pour le texte que l’utilisateur verra. Dans la liste déroulante Sélectionner un champ de données pour la valeur de RadioButtonList, sélectionnez le champ des données qui peut être accessible par programme lorsque l’utilisateur choisit un élément dans la liste.

Pour définir des éléments pour le contrôle RadioButtonList

1. En mode Création, cliquez avec le bouton droit sur le contrôle RadioButtonList, puis cliquez sur Afficherles tâches de contrôle courantes.

2. Dans le menu Tâches courantes du contrôle RadioButtonList, cliquez sur Modifier les éléments.

3. Dans la boîte de dialogue Éditeur de collections ListItem, cliquez sur Ajouter pour ajouter un élément.

4. Dans la zone Propriétés ListItem, définissez les propriétés Texte et Valeur.

5. Répétez les étapes 3 à 4 jusqu’à ce que vous ayez ajouté tous les éléments souhaités.

Pour une description complète de toutes les propriétés du contrôle RadioButtonList, voir Propriétés RadioButtonList dans MSDN Library.

Comparaison des contrôles RadioButton et RadioButtonList

Vous ajoutez des contrôles RadioButton individuels à une page et travaillez avec eux séparément. En général, vous groupez plusieurs boutons.

Par opposition, le contrôle RadioButtonList est un contrôle unique qui agit comme un contrôle parent pour une collection d’éléments de liste de cases d’option.

Chaque type de contrôle a des avantages. Les contrôles RadioButtonList individuels vous laissent plus de liberté quant à la disposition du groupe de cases d’option. Par exemple, vous pouvez inclure du texte (c’est-à-dire du texte ne correspondant pas à une case d’option) entre des cases d’option.

Le contrôle RadioButtonList ne vous permet pas d’insérer du texte entre les cases d’option, mais il est beaucoup plus facile à utiliser si vous souhaitez lier les cases d’option à une source de données. Le code qui détermine la case d’option sélectionnée semble également un peu plus simple à écrire.

Le contrôle RadioButtonList déclenche un événement SelectedIndexChanged lorsque les utilisateurs changent la case d’option sélectionnée dans la liste. Par défaut, l’événement ne provoque pas la publication du formulaire sur le serveur, bien que vous puissiez spécifier cette option en affectant la valeur vraie à la propriété AutoPostBack. Pour plus de détails, voir Comment répondre à la sélection d’un utilisateur dans un groupe de contrôles serveur Web RadioButton dans MSDN Library.

Remarque :
La capacité d’un contrôle RadioButtonList à effectuer des publications sur le serveur lorsqu’il est sélectionné exige que le navigateur prenne en charge ECMAScript (JScript, JavaScript) et que ce script soit activé dans le navigateur de l’utilisateur.