System.Web.UI.WebControls Namespace WebControl Class
Sets or retrieves a value indicating whether a Web control is enabled.
| Inline |
<asp:control enabled [ = true | false ] ... > |
| Script |
WebControl.Enabled [ = true | false ] |
This property accepts or returns only a boolean value, meaning true if a control is enabled, and false if not.
This property is read/write with a default value of true.
Enabled is used to specify or determine whether a control is functional. When set to false, the property has the following effects on a control:
- Disabled controls do not receive focus.
- Disabled controls are skipped in tabbing navigation.
- The data contained in a disabled control cannot be submitted with the form data set.
How disabled elements are rendered depends on the browser. In Microsoft® Internet Explorer® 4 and later, disabled controls appear dimmed and does not respond to user input.
NOTE: This property propagates down the control hierarchy. Hence, disabling a container control disables all child controls within that container.
The following example shows how to declaratively set the Enabled property of a Web control at design time.
<asp:textbox id = "myTextBox" enabled = "false" runat = "server" />
The example below shows how to programmatically enable and disable a Web control at run time, depending on the status of another control that is set by the user.
<script language = "C#" runat = "server">
void Page_Load ( Object src, EventArgs e ) {
myEmail.Enabled = join.Checked ? true : false;
}
</script>
Show me
WebControl Members Base Web Control Properties
