This documentation is archived and is not being maintained.

HtmlInputCheckBox Class

Allows programmatic access to the HTML <input type= checkbox> element on the server.

Namespace:  System.Web.UI.HtmlControls
Assembly:  System.Web (in System.Web.dll)

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class HtmlInputCheckBox : HtmlInputControl, 
<asp:HtmlInputCheckBox />

Use the HtmlInputCheckBox control to allow the user to select a true or false state. To determine whether the control is selected, use the Checked property. The HtmlInputCheckBox control provides a ServerChange event that is raised when the Checked property changes values between posts to the server. This allows you to create an event handler that performs a custom set of instructions each time the event is raised.


The HtmlInputCheckBox control does not post back to the server when it is clicked. You must provide another control on the Web page that supports posting to the server, such as an HtmlButton control, to send the state of the control back to the server.

For a list of initial property values for an instance of HtmlInputCheckBox, see the HtmlInputCheckBox constructor.

The following code example demonstrates a set of simple responses to users selecting from a group of HtmlInputCheckBox controls.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
<html xmlns=""  >
  <script language="C#" runat="server">

    protected void SubmitBtn_Click(object sender, EventArgs e)
      if (Basketball.Checked)
        // You like basketball

      if (Football.Checked)
        // You like football

      if (Soccer.Checked)
        // You like soccer

    <head runat="server">
    <title>ASP.NET Example</title>
       <form id="Form1" method="post" runat="server">
         Enter Interests:  
         <input id="Basketball" checked="checked" type="checkbox" runat="server" /> Basketball
         <input id="Football" type="checkbox" runat="server" /> Football
         <input id="Soccer" type="checkbox" runat="server" /> Soccer

         <input id="Button1" type="button" value="Enter" onserverclick="SubmitBtn_Click" runat="server" />

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0