Compartir a través de

Sintaxis declarativa del control de servidor HtmlInputCheckBox

  • Artículo

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

Crea un control de cliente que realiza una asignación al elemento HTML <input type=checkbox> y permite crear un control de casilla que permite al usuario seleccionar un estado true o 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"
    />

Comentarios

Utilice el control HtmlInputCheckBox para programar basándose en el elemento HTML <input type=checkbox>. El control HtmlInputCheckBox no devuelve datos al servidor cuando se hace clic en él. El estado de la casilla se envía al servidor para su procesamiento cuando se utiliza un control que devuelve datos al servidor, como el control HtmlInputButton. Para determinar si la casilla está activada, pruebe la propiedad Checked del control.

Nota

Este control no requiere una etiqueta de cierre.

Ejemplo

En el siguiente ejemplo se muestra cómo crear un control HtmlInputCheckBox que permite al usuario seleccionar un estado true o false. Cuando un usuario hace clic en el botón de entrada de datos incluido en la página, el controlador del evento Button1_Click determina si se ha seleccionado el control HtmlInputCheckBox. Entonces se muestra un mensaje en el control <span>. Tenga en cuenta que aunque el valor seleccionado se establezca como true de manera predeterminada en este ejemplo, el usuario sigue teniendo que hacer clic en Button1 para mostrar el texto.

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

Vea también

Referencia

HtmlInputCheckBox

Otros recursos

Controles de servidor HTML