Allows programmatic access to the HTML <input type= checkbox> element on the server.
(in System.Web.dll)
Visual Basic (Declaration)
<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class HtmlInputCheckBox _
Inherits HtmlInputControl _
Implements IPostBackDataHandler
Dim instance As HtmlInputCheckBox
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class HtmlInputCheckBox : HtmlInputControl,
IPostBackDataHandler
[AspNetHostingPermissionAttribute(SecurityAction::LinkDemand, Level = AspNetHostingPermissionLevel::Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction::InheritanceDemand, Level = AspNetHostingPermissionLevel::Minimal)]
public ref class HtmlInputCheckBox : public HtmlInputControl,
IPostBackDataHandler
public class HtmlInputCheckBox extends HtmlInputControl implements IPostBackDataHandler
<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.
.gif) Note: |
|---|
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="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html >
<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>
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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>
<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="JScript" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html >
<script language="JSCRIPT" runat="server">
function SubmitBtn_Click (source : Object, e : EventArgs){
if(Basketball.Checked == true){
// You like basketball
}
if(Football.Checked == true){
// You like football
}
if(Soccer.Checked == true){
// 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 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 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
Reference
Other Resources