Compartir a través de

Sintaxis declarativa del control de servidor Web CheckBox

  • Artículo

Actualización: noviembre 2007

Crea un control de casilla de verificación que permita al usuario cambiar del estado true al estado false, y viceversa.

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

Comentarios

El control CheckBox crea una casilla de verificación en la página de formularios Web Forms que permite al usuario cambiar del estado true al estado false y viceversa. Para especificar el título que se va a mostrar en el control, establezca el valor de la propiedad Text. El título puede aparecer a la derecha o a la izquierda de la casilla de verificación. Establezca la propiedad TextAlign para especificar el lado donde va a aparecer el título.

Nota

Dado que el elemento <asp:CheckBox> no tiene contenido, se puede cerrar la etiqueta con /> en lugar de utilizar una etiqueta de cierre independiente.

Para determinar si el control CheckBox está seleccionado, compruebe la propiedad Checked. Se provoca el evento CheckedChanged cuando el estado del control CheckBox cambia entre los distintos envíos al servidor. Se puede proporcionar un controlador de eventos para el evento CheckedChanged para que realice una tarea específica cuando el estado del control CheckBox cambia entre los distintos envíos al servidor.

Nota

Cuando se crean varios controles CheckBox, se puede usar asimismo el control CheckBoxList. El control CheckBoxList es más fácil de usar para crear un conjunto de casillas de verificación mediante el enlace de datos, mientras que el control CheckBox individual permite un mayor control sobre el diseño.

De manera predeterminada, el control CheckBox no envía automáticamente el formulario al servidor cuando se hace clic en él. Para habilitar el envío automático, establezca el valor de la propiedad AutoPostBack en true.

4s78d0k1.alert_caution(es-es,VS.90).gifPrecaución:

El texto no contiene código HTML antes de mostrarse en el control CheckBox. Esto permite incrustar una secuencia de comandos en las etiquetas HTML del texto. Si los valores del control provienen de la entrada del usuario, asegúrese de validar los valores para ayudar a evitar puntos vulnerables en la seguridad.

Para obtener información detallada sobre las propiedades y eventos del control de servidor Web CheckBox, consulte la información relativa a la clase CheckBox.

Ejemplo

En el ejemplo siguiente se muestra cómo declarar un control CheckBox en un archivo .aspx. Se configura la casilla de verificación de modo que, al activarse, se devuelva inmediatamente el formulario al servidor.

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

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

En el siguiente ejemplo se muestra cómo crear un controlador de eventos para el evento CheckedChanged con el fin de copiar el contenido de un cuadro de texto con la dirección de facturación de un cliente en un cuadro de texto que contiene la dirección de envío.

4s78d0k1.alert_security(es-es,VS.90).gifNota de seguridad:

En este ejemplo hay un cuadro de texto que acepta datos del usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, las páginas Web ASP.NET validan los datos escritos por el usuario para comprobar que no incluyen secuencias de comandos ni elementos HTML. Para obtener más información, consulte Información general sobre los ataques mediante secuencias de comandos.

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

Vea también

Referencia

CheckBox

Otros recursos

Sintaxis de los controles de servidor Web