WebControl.SupportsDisabledAttribute Propiedad

Definición

Obtiene un valor que indica si el control debe establecer en "disabled" el atributo disabled del elemento HTML representado cuando el valor de la propiedad IsEnabled del control es false.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

public:
 virtual property bool SupportsDisabledAttribute { bool get(); };
[System.ComponentModel.Browsable(false)]
public virtual bool SupportsDisabledAttribute { get; }
member this.SupportsDisabledAttribute : bool
Public Overridable ReadOnly Property SupportsDisabledAttribute As Boolean

Valor de propiedad

Siempre true.Always true.

Atributos

Ejemplos

En el ejemplo siguiente se muestra el marcado de un control de Label deshabilitado:The following example shows markup for a disabled Label control:

<asp:Label id="Label1" runat="server" Text="Test" Enabled="false"/>

En ASP.NET 3,5 y versiones anteriores, este marcado presenta el siguiente código HTML:In ASP.NET 3.5 and earlier versions, this markup renders the following HTML:

<span id="Label1" disabled="disabled">Test</span>

En ASP.NET 4, si el valor de la propiedad RenderingCompatibility es 4,0 o superior y si la propiedad DisabledCssClass se establece en su valor predeterminado, el mismo marcado presenta el siguiente código HTML:In ASP.NET 4, if the value of the RenderingCompatibility property is 4.0 or greater, and if the DisabledCssClass property is set to its default value, the same markup renders the following HTML:

<span id="Label1" class="aspNetDisabled">Test</span>

Comentarios

En las clases derivadas, esta propiedad indica el modo en que ASP.NET debe representar HTML para un control cuando el control está deshabilitado.In derived classes, this property indicates how ASP.NET should render HTML for a control when the control is disabled.

Deshabilitar controles Web ASP.NETDisabling ASP.NET Web Controls

Cuando la propiedad Enabled de un control ASP.NET se establece en false (es decir, cuando el control está deshabilitado), la intención es que ASP.NET debe representar el control en la página, pero que se muestra en un Estado deshabilitado (normalmente atenuado).When the Enabled property of an ASP.NET control is set to false (that is, when the control is disabled), the intent is that ASP.NET should render the control in the page, but display it in a disabled state (typically dimmed). Si un control primario está deshabilitado, los elementos secundarios de ese control también se muestran como deshabilitados.If a parent control is disabled, children of that control are also displayed as disabled. En ese caso, la propiedad IsEnabled del control secundario se establece en false, aunque su propiedad Enabled se pueda establecer en true.In that case, the child control's IsEnabled property is set to false, even though its Enabled property might be set to true.

En ASP.NET 3,5 y versiones anteriores, cuando se falsela propiedad IsEnabled de un control, ASP.NET establece el atributo disabled en "Disabled" en el elemento HTML que representa para el control.In ASP.NET 3.5 and earlier versions, when a control's IsEnabled property is false, ASP.NET sets the disabled attribute to "disabled" in the HTML element that it renders for the control. Sin embargo, el estándar HTML 4,01 permite el disabled atributo solo en determinados elementos que se usan para la entrada del usuario.However, the HTML 4.01 standard allows the disabled attribute only on certain elements that are used for user input. Por ejemplo, el atributo disabled se permite para los elementos input, pero no para los elementos span.For example, the disabled attribute is allowed for input elements, but not for span elements.

La mayoría de los exploradores admiten una apariencia deshabilitada predeterminada para los elementos de solo visualización que tienen atributos disabled.Most browsers support a default disabled appearance for display-only elements that have disabled attributes. Sin embargo, para cumplir con los estándares HTML, de forma predeterminada ASP.NET 4 omite los atributos no válidos.However, in order to comply with HTML standards, by default ASP.NET 4 omits invalid attributes.

Cómo se usa la propiedad SupportsDisabledAttributeHow the SupportsDisabledAttribute Property is Used

Si la propiedad SupportsDisabledAttribute es true, ASP.NET representa un atributo disabled cuando el control está deshabilitado.If the SupportsDisabledAttribute property is true, ASP.NET renders a disabled attribute when the control is disabled. Si esta propiedad es false, ASP.NET representa un atributo de class cuando el control está deshabilitado.If this property is false, ASP.NET renders a class attribute when the control is disabled.

Las clases derivadas invalidan esta propiedad para devolver false si se cumplen todas las condiciones siguientes:Derived classes override this property to return false if all the following conditions are true:

  • El control representa un elemento HTML que no admite el atributo disabled.The control renders an HTML element that does not support the disabled attribute.

  • La propiedad RenderingCompatibility indica un número de versión de ASP.NET inferior a 4,0.The RenderingCompatibility property indicates an ASP.NET version number lower than 4.0.

La propiedad SupportsDisabledAttribute no indica necesariamente si el elemento HTML que se representa para un control admite (permite) el atributo de disabled.The SupportsDisabledAttribute property does not necessarily indicate whether the HTML element that is rendered for a control supports (allows) the disabled attribute. Si la propiedad RenderingCompatibility de un control indica un número de versión de ASP.NET inferior a 4,0, el valor de la propiedad SupportsDisabledAttribute del control podría devolver true aunque el HTML representado no admita el atributo disabled.If a control's RenderingCompatibility property indicates an ASP.NET version number lower than 4.0, the value of the control's SupportsDisabledAttribute property might return true even if the rendered HTML does not support the disabled attribute.

Compatibilidad con versiones anteriores de los controles deshabilitadosBackward Compatibility for Disabled Controls

Cuando se usa Visual Studio para actualizar un proyecto web a ASP.NET 4 desde una versión anterior, Visual Studio establece automáticamente el atributo de controlRenderingCompatibilityVersion en el archivo Web. config (que establece la propiedad RenderingCompatibility) en el número de versión anterior.When you use Visual Studio to upgrade a Web project to ASP.NET 4 from an earlier version, Visual Studio automatically sets the controlRenderingCompatibilityVersion attribute in the Web.config file (which sets the RenderingCompatibility property) to the earlier version number. Dado que la propiedad SupportsDisabledAttribute siempre devuelve true cuando la propiedad RenderingCompatibility es inferior a 4,0, esto hace que los controles Web representen HTML para los controles deshabilitados como ocurría en la versión anterior.Because the SupportsDisabledAttribute property always returns true when the RenderingCompatibility property is lower than 4.0, this causes Web controls to render HTML for disabled controls as they did in the earlier version. Si desea que un sitio web actualizado represente HTML usando el algoritmo introducido en ASP.NET 4, puede cambiar o quitar el atributo de controlRenderingCompatibilityVersion.If you want an upgraded Web site to render HTML using the algorithm introduced in ASP.NET 4, you can change or remove the controlRenderingCompatibilityVersion attribute. Para obtener más información, vea la propiedad RenderingCompatibility.For more information, see the RenderingCompatibility property.

Establecer una apariencia deshabilitada mediante CSSSetting a Disabled Appearance By Using CSS

Si se false la propiedad SupportsDisabledAttribute de un control y el control está deshabilitado, ASP.NET establece el atributo class del elemento HTML representado en el valor de la propiedad WebControl.DisabledCssClass.If the SupportsDisabledAttribute property of a control is false and the control is disabled, ASP.NET sets the class attribute of the rendered HTML element to the value of the WebControl.DisabledCssClass property. El valor predeterminado de la propiedad WebControl.DisabledCssClass es "aspNetDisabled".The default value of the WebControl.DisabledCssClass property is "aspNetDisabled".

Para proporcionar una apariencia deshabilitada para los controles deshabilitados, debe definir una regla de CSS para la clase representada por el valor de la propiedad WebControl.DisabledCssClass.To provide a disabled appearance for disabled controls, you must define a CSS rule for the class that is represented by the value of the WebControl.DisabledCssClass property.

El elemento HTML que se representa para un control puede tener más de un valor en su atributo class si hay un valor en su propiedad CssClass.The HTML element that is rendered for a control might have more than one value in its class attribute if there is a value in its CssClass property. Para obtener más información, vea la propiedad DisabledCssClass.For more information, see the DisabledCssClass property.

Se aplica a

Consulte también: