System.Web.UI.HtmlControls.HtmlInputCheckBox Class

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

See Also: HtmlInputCheckBox Members

Syntax

[System.Web.UI.SupportsEventValidation]
[System.ComponentModel.DefaultEvent("ServerChange")]
public class HtmlInputCheckBox : HtmlInputControl, System.Web.UI.IPostBackDataHandler

Remarks

Use the System.Web.UI.HtmlControls.HtmlInputCheckBox control to allow the user to select a true or false state. To determine whether the control is selected, use the HtmlInputCheckBox.Checked property. The System.Web.UI.HtmlControls.HtmlInputCheckBox control provides a HtmlInputCheckBox.ServerChange event that is raised when the HtmlInputCheckBox.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.

Note:

The System.Web.UI.HtmlControls.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 System.Web.UI.HtmlControls.HtmlButton control, to send the state of the control back to the server.

For a list of initial property values for an instance of System.Web.UI.HtmlControls.HtmlInputCheckBox, see the HtmlInputCheckBox.#ctor constructor.

Requirements

Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0