Export (0) Print
Expand All

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)

public class HtmlInputCheckBox : HtmlInputControl, IPostBackDataHandler
public class HtmlInputCheckBox extends HtmlInputControl implements IPostBackDataHandler
public class HtmlInputCheckBox extends HtmlInputControl implements IPostBackDataHandler

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.

NoteNote

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#" %>

<html >
  <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
      }
    
    }
</script>
    <body>
       <form id="Form1" method=post runat=server>
         Enter Interests:  
         <input id="Basketball" 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>
        </form>
    </body>
 </html>
   

System.Object
   System.Web.UI.Control
     System.Web.UI.HtmlControls.HtmlControl
       System.Web.UI.HtmlControls.HtmlInputControl
        System.Web.UI.HtmlControls.HtmlInputCheckBox

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 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft