HtmlInputCheckBox.Checked Property

Reference

Definition

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets a value indicating whether the HtmlInputCheckBox is selected.

public:
 property bool Checked { bool get(); void set(bool value); };

public bool Checked { get; set; }

[System.ComponentModel.TypeConverter(typeof(System.Web.UI.MinimizableAttributeTypeConverter))]
public bool Checked { get; set; }

member this.Checked : bool with get, set

[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.MinimizableAttributeTypeConverter))>]
member this.Checked : bool with get, set

Public Property Checked As Boolean

Property Value

Boolean

true if the HtmlInputCheckBox control is selected; otherwise, false.

Attributes: TypeConverterAttribute

Examples

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

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

<!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"  >
  <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>
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
       <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" />
        </form>
    </body>
 </html>

<%@ 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" >
    <script language="VB" runat="server">
       Sub SubmitBtn_Click (Source As Object, ByVal E as EventArgs)
           If (Basketball.Checked = true) Then 
               ' You like basketball
           End If
 
           If (Football.Checked = true) Then
               ' You like football
           End If
 
           If (Soccer.Checked = true) Then
               ' You like soccer
           End If
       End Sub
    </script>
  
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
       <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 type="button" value="Enter" onserverclick="SubmitBtn_Click" runat="server" />
        </form>
    </body>
 </html>

Remarks

Use this property to determine whether the HtmlInputCheckBox control is selected. This property can also be used to programmatically set the state of the HtmlInputCheckBox control.

Applies to