Partager via

Syntaxe déclarative du contrôle serveur HtmlInputCheckBox

  • Article

Crée un contrôle côté serveur mappé à l'élément HTML <input type=checkbox> et permet de créer un contrôle de type case à cocher qui offre à l'utilisateur la possibilité de sélectionner un état true ou false.

<input
    Type="Checkbox"
    EnableViewState="False|True"
    Id="string"
    Visible="False|True"
    OnDataBinding="OnDataBinding event handler"
    OnDisposed="OnDisposed event handler"
    OnInit="OnInit event handler"
    OnLoad="OnLoad event handler"
    OnPreRender="OnPreRender event handler"
    OnServerChange="OnServerChange event handler"
    OnUnload="OnUnload event handler"
    runat="server"
    />

Notes

Utilisez le contrôle HtmlInputCheckBox pour programmer en vous servant de l'élément HTML <input type=checkbox>. Le contrôle HtmlInputCheckBox n'est pas republié sur le serveur lorsqu'un clic a été effectué. L'état de la case à cocher est envoyé au serveur pour traitement lorsque vous utilisez un contrôle qui est republié sur le serveur, tel que le contrôle HtmlInputButton. Pour déterminer si la case à cocher est activée, testez la propriété Checked du contrôle.

RemarqueRemarque

Ce contrôle ne nécessite pas de balise de fermeture.

Exemple

L'exemple suivant montre comment créer un contrôle HtmlInputCheckBox qui permet à l'utilisateur de sélectionner un état true ou false. Lorsqu'un utilisateur clique sur le bouton d'entrée inclus sur la page, le gestionnaire d'événements Button1_Click détermine si le contrôle HtmlInputCheckBox est activé. Il affiche ensuite un message dans un contrôle <span>. Notez que, même si la valeur activée est true par défaut dans cet exemple, l'utilisateur doit néanmoins cliquer sur Button1 pour afficher le texte.

<%@ 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>
<title>HtmlInputCheckBox Control</title>

   <script runat="server">
      Sub Button1_Click(Source As Object, e As EventArgs)
         If Check1.Checked = True Then
            Span1.InnerHtml = "Check1 is checked!"
         Else
            Span1.InnerHtml = "Check1 is not checked!"
         End If
      End Sub
   </script>

</head>
<body>

    <h3>HtmlInputCheckBox Sample</h3>

    <form id="Form1" runat="server">
        <input id="Check1" type="checkbox" runat="server" checked="checked"/> 
            CheckBox1 &nbsp;&nbsp;
        <span id="Span1" style="color:red" runat="server" />
        <br />
        <input type="button" id="Button1" value="Enter"
               onserverclick="Button1_Click" runat="server"/>
    </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>
<title>HtmlInputCheckBox Control</title>

    <script runat="server">
       void Button1_Click(object Source, EventArgs e) 
       {
          if (Check1.Checked == true) 
          {
             Span1.InnerHtml = "Check1 is checked!";
          }
          else 
          {
             Span1.InnerHtml = "Check1 is not checked!";
          }
       }
    </script>

</head>
<body>

    <h3>HtmlInputCheckBox Sample</h3>

    <form id="Form1" runat="server">
        <input id="Check1" type="checkbox" runat="server" checked="checked"/> 
            CheckBox1 &nbsp;&nbsp;
        <span id="Span1" style="color:red" runat="server" />
        <br />
        <input type="button" id="Button1" value="Enter"
               onserverclick="Button1_Click" runat="server"/>
    </form>
</body>
</html>

Voir aussi

Référence

HtmlInputCheckBox

Autres ressources

Contrôles serveur HTML