This is a read-only property. If you want to disable a control, you set its WebControl.Enabled property to false.

If a control is not contained by another control, the value of the WebControl.IsEnabled property is always the same as the value of the WebControl.Enabled property.

The WebControl.IsEnabled property has a value that is different from the WebControl.Enabled property if a control is a child of another control and if all the following circumstances are true:

• The value of the WebControl.Enabled property or the WebControl.IsEnabled property of the parent control is false.

• The WebControl.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 WebControl.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 WebControl.Enabled property to false. The parent control itself might have its WebControl.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 WebControl.SupportsDisabledAttribute and System.Web.Configuration.PagesSection.ControlRenderingCompatibilityVersion.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0