Partager via

Syntaxe déclarative du contrôle serveur Web CheckBox

  • Article

Mise à jour : novembre 2007

Crée un contrôle CheckBox qui permet à l'utilisateur de basculer entre les états true et false.

<asp:CheckBox
    AccessKey="string"
    AutoPostBack="True|False"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    Checked="True|False"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnCheckedChanged="CheckedChanged event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Text="string"
    TextAlign="Left|Right"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

Notes

Le contrôle CheckBox crée une case à cocher sur la page Web Forms qui permet à l'utilisateur de basculer entre les états true et false. Vous pouvez spécifier la légende à afficher dans le contrôle en définissant la propriété Text. La légende peut s'afficher à droite ou à gauche de la case à cocher. Définissez la propriété TextAlign pour spécifier de quel côté la légende s'affiche.

Remarque :

Dans la mesure où l'élément <asp:CheckBox> n'a pas de contenu, vous pouvez fermer la balise avec /> au lieu d'une balise de fermeture distincte.

Pour déterminer si le contrôle CheckBox est sélectionné, testez la propriété Checked. L'événement CheckedChanged est déclenché lorsque l'état du contrôle CheckBox change entre deux publications sur le serveur. Vous pouvez fournir un gestionnaire d'événements pour l'événement CheckedChanged afin qu'une tâche spécifique soit exécutée lorsque l'état du contrôle CheckBox change d'une publication à une autre.

Remarque :

Lorsque vous créez plusieurs contrôles CheckBox, vous pouvez également utiliser le contrôle CheckBoxList. Le contrôle CheckBoxList permet de créer plus facilement un ensemble de cases à cocher à l'aide de la liaison de données, tandis que le contrôle CheckBox individuel offre un meilleur contrôle de la mise en page.

Par défaut, le contrôle CheckBox ne publie pas automatiquement le formulaire sur le serveur lors d'un clic sur le contrôle. Pour activer la publication automatique, affectez la valeur true à la propriété AutoPostBack.

Attention :

Le texte n'est pas codé au format HTML avant d'être affiché dans le contrôle CheckBox. Il est ainsi possible d'incorporer du script dans les balises HTML dans le texte. Si les valeurs du contrôle proviennent des entrées d'utilisateur, veillez à valider les valeurs pour permettre d'empêcher les failles en matière de sécurité.

Pour plus d'informations sur les propriétés et événements du contrôle serveur Web CheckBox, consultez la documentation de la classe CheckBox.

Exemple

L'exemple suivant illustre un exemple de déclaration d'un contrôle CheckBox dans un fichier .aspx. La case à cocher est définie de façon à publier immédiatement le formulaire sur le serveur quand elle est activée.

<asp:CheckBox id="Check1" runat="server"
     Text="CheckBox 1"
     AutoPostBack="True"/>

<asp:CheckBox id="Check1" runat="server"
     Text="CheckBox 1"
     AutoPostBack="True"/>

L'exemple suivant montre comment créer un gestionnaire d'événements pour l'événement CheckedChanged afin de copier le contenu d'une zone de texte comportant l'adresse de facturation d'un client dans une zone de texte qui contient l'adresse de livraison.

Note de sécurité :

Cet exemple a une zone de texte qui accepte l'entrée d'utilisateur, ce qui constitue une menace éventuelle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que les entrées d'utilisateur n'incluent pas de script ou d'éléments HTML. Pour plus d'informations, consultez Vue d'ensemble des attaques de script.

 
<%@ Page Language="VB" 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 runat="server">
<title>CheckBox Web Server Control Declarative Syntax</title>

   <script runat="server">

      Sub Check_Clicked(sender As Object, e As EventArgs) 

         If SameCheckBox.Checked Then
            ShipTextBox.Text = BillTextBox.Text
         Else
            ShipTextBox.Text = ""
         End If

      End Sub

   </script>

</head>

<body>

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

      <h3>CheckBox Example</h3>








      <table>
         <tr>
            <td>
               Billing Address: <br />
               <asp:TextBox id="BillTextBox"
                    TextMode="MultiLine"
                    Rows="5" 
                    runat="server"/>
            </td>
            <td>
               Shipping Address: <br />
               <asp:TextBox id="ShipTextBox"
                    TextMode="MultiLine"
                    Rows="5" 
                    runat="server"/>
            </td>
         </tr>
         <tr>
            <td>
            </td>
            <td>
               <asp:CheckBox id="SameCheckBox"
                    AutoPostBack="True"
                    Text="Same as billing."
                    TextAlign="Right"
                    OnCheckedChanged="Check_Clicked"
                    runat="server"/>
            </td>
         </tr>
      </table>


   </form>

</body>
</html>

<%@ 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 runat="server">
    <title>CheckBox Example</title>
<script runat="server">

      void Check_Clicked(Object sender, EventArgs e) 
      {
         if(SameCheckBox.Checked)
            ShipTextBox.Text = BillTextBox.Text;
         else
            ShipTextBox.Text = "";
      }

   </script>

</head>

<body>

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

      <h3>CheckBox Example</h3>








      <table>
         <tr>
            <td>
               Billing Address: <br />
               <asp:TextBox id="BillTextBox"
                    TextMode="MultiLine"
                    Rows="5" 
                    runat="server"/>
            </td>
            <td>
               Shipping Address: <br />
               <asp:TextBox id="ShipTextBox"
                    TextMode="MultiLine"
                    Rows="5" 
                    runat="server"/>
            </td>
         </tr>
         <tr>
            <td>
            </td>
            <td>
               <asp:CheckBox id="SameCheckBox"
                    AutoPostBack="True"
                    Text="Same as billing."
                    TextAlign="Right"
                    OnCheckedChanged="Check_Clicked"
                    runat="server"/>
            </td>
         </tr>
      </table>


   </form>

</body>
</html>

Voir aussi

Référence

CheckBox

Autres ressources

Syntaxe des contrôles serveur Web