WebControl.IsEnabled Property
Definition
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 a value indicating whether the control is enabled.
protected public:
property bool IsEnabled { bool get(); };
protected internal bool IsEnabled { get; }
member this.IsEnabled : bool
Protected Friend ReadOnly Property IsEnabled As Boolean
Property Value
true
if the WebControl object is enabled; otherwise, false
.
Remarks
This is a read-only property. If you want to disable a control, you set its Enabled property to false
.
If a control is not contained by another control, the value of the IsEnabled property is always the same as the value of the Enabled property.
The IsEnabled property has a value that is different from the Enabled property if a control is a child of another control and if all the following circumstances are true:
The value of the Enabled property or the IsEnabled property of the parent control is
false
.The Enabled property of the child control is set to
true
.
In this situation, the child control inherits the disabled state of the parent control. The IsEnabled property of the child control returns false
to indicate that the control is disabled even though the child control was not explicitly disabled by setting its Enabled property to false
. The parent control itself might have its Enabled property set to true
but might inherit the disabled state from its parent, and so on.
When ASP.NET renders HTML elements for a server control, it marks the elements as disabled by setting their disabled
attribute or their CSS class
attribute. For more information, see SupportsDisabledAttribute and ControlRenderingCompatibilityVersion.