Exporter (0) Imprimer
Développer tout

CheckBoxList, classe

Crée un groupe de cases à cocher à sélection multiple qui peut être généré de manière dynamique en liant le contrôle à une source de données.

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

public class CheckBoxList : ListControl, IRepeatInfoUser, INamingContainer, IPostBackDataHandler
public class CheckBoxList extends ListControl implements IRepeatInfoUser, INamingContainer, 
	IPostBackDataHandler
public class CheckBoxList extends ListControl implements IRepeatInfoUser, INamingContainer, 
	IPostBackDataHandler

Le contrôle CheckBoxList fournit un groupe de cases à cocher à sélection multiple qui peut être généré de manière dynamique avec la liaison de données. Il contient une collection Items avec des membres correspondant à des éléments individuels dans la liste. Pour déterminer quels éléments sont activés, parcourez la collection et testez la propriété Selected de chaque élément de la liste.

Vous pouvez spécifier la manière dont la liste est affichée en utilisant les propriétés RepeatLayout et RepeatDirection. Si la propriété RepeatLayout a la valeur RepeatLayout.Table (paramètre par défaut), la liste est rendue dans un tableau. Si elle a la valeur RepeatLayout.Flow, la liste est rendue sans structure de tableau. RepeatDirection a la valeur par défaut RepeatDirection.Vertical. L'affectation de la valeur RepeatDirection.Horizontal à cette propriété rend la liste horizontalement.

Le contrôle CheckBoxList offre des fonctionnalités de liaison de données pratiques. Toutefois, les contrôles CheckBox individuels offrent un meilleur contrôle de la disposition.

AttentionAttention

Ce contrôle peut être utilisé pour afficher des entrées d'utilisateur susceptibles de contenir un script client malveillant. Vérifiez toutes les informations envoyées par un client pour un script exécutable, des instructions SQL ou un autre code avant de les afficher dans votre application. Vous pouvez utiliser des contrôles de validation pour vérifier l'entrée d'utilisateur avant d'afficher le texte d'entrée dans un contrôle. ASP.NET fournit une fonctionnalité de validation de la demande d'entrée pour bloquer les scripts et le code 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 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
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 : ajouter des contrôles serveur Web CheckBox à 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 Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web CheckBoxList à une page Web Forms (Visual Studio)Gé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 éléments dans des contrôles 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 à l'aide de Visual Web Developer
Comment : ajouter des contrôles serveur Web CheckBox à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
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 : ajouter des contrôles serveur Web CheckBoxList à une page Web Forms (Visual Studio)Gé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
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 : définir la disposition dans un contrôle serveur Web CheckBoxListGé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é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 : définir la disposition dans un contrôle serveur Web CheckBoxListGé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 serveur Web CheckBoxList à 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 : ajouter des contrôles serveur Web CheckBox à une page Web FormsGénération d'applications Web ASP.NET
Comment : ajouter des contrôles serveur Web CheckBox à une page Web Forms (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
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 : ajouter des contrôles serveur Web CheckBoxList à une page Web Forms (Visual Studio)Gé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
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 : définir la disposition dans un contrôle serveur Web CheckBoxListGénération d'applications Web ASP.NET dans Visual Studio

L'exemple de code suivant illustre la création d'un contrôle CheckBoxList sur une page Web.

RemarqueRemarque

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" %>

<html>

<head>

   <script runat="server">

      void Check_Clicked(Object sender, EventArgs e) 
      {

         Message.Text = "Selected Item(s):<br><br>";

         // Iterate through the Items collection of the CheckBoxList 
         // control and display the selected items.
         for (int i=0; i<checkboxlist1.Items.Count; i++)
         {

            if (checkboxlist1.Items[i].Selected)
            {

               Message.Text += checkboxlist1.Items[i].Text + "<br>";

            }

         }

      }

   </script>
 
</head>

<body>
   
   <form runat="server">
 
      <h3> CheckBoxList Example </h3>

      Select items from the CheckBoxList.

      <br><br>

      <asp:CheckBoxList id="checkboxlist1" 
           AutoPostBack="True"
           CellPadding="5"
           CellSpacing="5"
           RepeatColumns="2"
           RepeatDirection="Vertical"
           RepeatLayout="Flow"
           TextAlign="Right"
           OnSelectedIndexChanged="Check_Clicked"
           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:CheckBoxList>
 
      <br><br>

      <asp:label id="Message" runat="server"/>
             
   </form>
          
</body>

</html>


  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

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

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft