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

CheckBox, classe

Affiche une case à cocher qui permet à l'utilisateur de sélectionner une condition true ou false.

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

[ControlValuePropertyAttribute("Checked")] 
public class CheckBox : WebControl, IPostBackDataHandler, ICheckBoxControl
/** @attribute ControlValuePropertyAttribute("Checked") */ 
public class CheckBox extends WebControl implements IPostBackDataHandler, ICheckBoxControl
ControlValuePropertyAttribute("Checked") 
public class CheckBox extends WebControl implements IPostBackDataHandler, ICheckBoxControl

Utilisez le contrôle CheckBox pour permettre à l'utilisateur de sélectionner un état true ou false.

Si vous comptez utiliser plusieurs contrôles CheckBox, le contrôle CheckBoxList est une alternative qui fournit des capacité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 qui peuvent inclure un script client nuisible. 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 les entrées 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 : validation des entrées d'utilisateur dans une page Web FormsGé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 : validation des entrées d'utilisateur dans une page Web FormsGé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 : obtenir et définir par programme une valeur du contrôle serveur Web CheckBoxGénération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser le contrôle ASP.NET CreateUserWizardGé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 CheckBoxList à une page Web FormsGénération d'applications Web ASP.NET
Comment : obtenir et définir par programme une valeur du contrôle serveur Web CheckBoxGénération d'applications Web ASP.NET
Comment : personnaliser le contrôle ASP.NET CreateUserWizardGé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 : ajouter des contrôles serveur Web CheckBox à une page Web FormsGénération d'applications Web ASP.NET
Comment : répondre à la sélection d'un utilisateur dans un contrôle serveur Web CheckBoxGé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 : obtenir et définir par programme une valeur du contrôle serveur Web CheckBoxGénération d'applications Web ASP.NET dans Visual Studio
Comment : personnaliser le contrôle ASP.NET CreateUserWizardGé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 : répondre à la sélection d'un utilisateur dans un contrôle serveur Web CheckBoxGénération d'applications Web ASP.NET dans Visual Studio
Comment : répondre à la sélection d'un utilisateur dans un contrôle serveur Web CheckBoxGénération d'applications Web ASP.NET dans Visual Studio

L'exemple suivant illustre l'utilisation d'un contrôle CheckBox pour indiquer si les taxes sont incluses dans le calcul d'un total de ventes.

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 des 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) 
      {

         // Calculate the subtotal and display the result in currency format.
         // Include tax if the check box is selected.
         Message.Text = CalculateTotal(checkbox1.Checked).ToString("c");

      }

      void Page_Load(Object sender, EventArgs e)
      {

         // Display the subtotal without tax when the page is first loaded.
         if(!IsPostBack)
         {

            // Calculate the subtotal and display the result in currency format.
            Message.Text = CalculateTotal(false).ToString("c");

         }

      }

      double CalculateTotal(bool Taxable)
      {

         // Calculate the subtotal for the example.
         double Result = 1.99 + 2.99 + 3.99;

         // Add tax, if applicable.
         if(Taxable)
         {
            Result += Result * 0.086;
         }

         return Result; 

      }
 
   </script>
 
</head>
 
<body>
 
   <form runat="server">
 
      <h3>CheckBox CheckedChanged Example</h3>

      Select whether to include tax in the subtotal.

      <br><br>

      <table border="1" cellpadding="5">

         <tr>

            <th colspan="2">

               Shopping cart

            </th>

         </tr>

         <tr>

            <td>

               Item 1

            </td>

            <td>

               $1.99

            </td>

         </tr>

         <tr>

            <td>

               Item 2

            </td>

            <td>

               $2.99

            </td>

         </tr>

         <tr>

            <td>

               Item 3

            </td>

            <td>

               $3.99

            </td>

         </tr>

         <tr>

            <td>

               <b>Subtotal</b>

            </td>

            <td>

               <asp:Label id="Message" runat="server"/>

            </td>

         </tr>

         <tr>

            <td colspan="2">

               <asp:CheckBox id="checkbox1" runat="server"
                    AutoPostBack="True"
                    Text="Include 8.6% sales tax"
                    TextAlign="Right"
                    OnCheckedChanged="Check_Clicked"/>

            </td>

         </tr>

      </table>
                   
   </form>
         
</body>

</html>


  • AspNetHostingPermission  pour fonctionner dans un environnement hébergé. Valeur de demande : LinkDemand. Valeur d'autorisation : Minimal.
  • AspNetHostingPermission  pour fonctionner 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
Afficher: