Control.RenderingCompatibility Control.RenderingCompatibility Control.RenderingCompatibility Control.RenderingCompatibility Property

Definición

Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

public:
 virtual property Version ^ RenderingCompatibility { Version ^ get(); void set(Version ^ value); };
[System.ComponentModel.Bindable(false)]
[System.ComponentModel.Browsable(false)]
public virtual Version RenderingCompatibility { get; set; }
member this.RenderingCompatibility : Version with get, set
Public Overridable Property RenderingCompatibility As Version

Valor de propiedad

Versión de ASP.NET compatible con los elementos HTML representados.The ASP.NET version that rendered HTML will be compatible with.

Comentarios

ASP.NET establece esta propiedad en el valor de la controlRenderingCompatibilityVersion atributo de la pages elemento en el archivo Web.config.ASP.NET sets this property to the value of the controlRenderingCompatibilityVersion attribute of the pages element in the Web.config file. Si el controlRenderingCompatibilityVersion atributo no está establecido en el archivo Web.config, el valor predeterminado es la versión actual de ASP.NET.If the controlRenderingCompatibilityVersion attribute is not set in the Web.config file, the default value is the current version of ASP.NET.

Precaución

Hay un descriptor de acceso público para esta propiedad, pero el descriptor de acceso set es compatible con la infraestructura de .NET Framework y no está pensado para utilizarse directamente desde el código.There is a public set accessor for this property, but the set accessor supports the .NET Framework infrastructure and is not intended to be used directly from your code. Si establece este valor en el código, el efecto es impredecible.If you set this value in your code, the effect is unpredictable.

Cada versión de ASP.NET podría representar HTML de forma diferente respecto a versiones anteriores.Each release of ASP.NET might render HTML differently from earlier releases. Por ejemplo, en ASP.NET 3.5, si la IsEnabled propiedad de un Label control es false, de forma predeterminada, ASP.NET representa un span elemento cuyo disabled atributo está establecido en "disabled".For example, in ASP.NET 3.5, if the IsEnabled property of a Label control is false, by default, ASP.NET renders a span element whose disabled attribute is set to "disabled". En ASP.NET 4, de forma predeterminada, el span elemento se representa con una hoja de estilos en cascada (CSS) class en lugar del atributo el disabled atributo.In ASP.NET 4, by default, the span element is rendered with a cascading style sheet (CSS) class attribute instead of the disabled attribute. Esto le permite especificar la apariencia del control deshabilitada y evita la representación de HTML no válido.This lets you specify the disabled appearance of the control and avoids rendering invalid HTML. (En HTML 4.0 y XHTML 1.1, el span elemento no admite el disabled atributo.)(In HTML 4.0 and XHTML 1.1, the span element does not support the disabled attribute.)

Una aplicación Web podría incluir código que podría no funcionar correctamente si cambia la representación en HTML.A Web application might include code that would not function correctly if HTML rendering changes. Para evitar este problema, puede establecer el controlRenderingCompatibilityVersion atributo de la pages elemento en el archivo Web.config para indicar qué versión anterior que desea mantener la compatibilidad con.To avoid this problem, you can set the controlRenderingCompatibilityVersion attribute of the pages element in the Web.config file to indicate which earlier version you want to maintain compatibility with. Por ejemplo, si establece la RenderingCompatibility propiedad 3.5, deshabilitado Label control representará un disabled atributo y no una clase CSS.For example, if you set the RenderingCompatibility property to 3.5, a disabled Label control will render a disabled attribute and not a CSS class.

Nota

Es la versión más antigua que se puede establecer esta propiedad en 3.5.The earliest version that you can set this property to is 3.5.

Para mantener la compatibilidad con versiones anteriores, 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 controlRenderingCompatibilityVersion atributo en el archivo Web.config para 3.5.To maintain backward compatibility, 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 to 3.5. Si desea que un sitio Web actualizado para representar HTML mediante el algoritmo que se introdujo en ASP.NET 4, puede cambiar o quitar el controlRenderingCompatibilityVersion atributo.If you want an upgraded Web site to render HTML using the algorithm that was introduced in ASP.NET 4, you can change or remove the controlRenderingCompatibilityVersion attribute.

La mayoría de los casos, el comportamiento controlado por esta propiedad es automático y no es necesario que comprobar la RenderingCompatibility propiedad en el código.Most of the time, the behavior controlled by this property is automatic and you do not have to check the RenderingCompatibility property in your code. Sin embargo, si está programando un control personalizado, es posible que deba incluir código que modifica el comportamiento del control en función del valor de esta propiedad.However, if you are programming a custom control, you might have to include code that alters the control's behavior based on the setting of this property. Por ejemplo, un control personalizado para ASP.NET 4 podría estar formado por Label controles y el control personalizado podrían especificar la apariencia del control deshabilitada mediante la generación de código JavaScript que modifica la aspNetDisabled clase.For example, a custom control for ASP.NET 4 might be composed of Label controls, and the custom control might specify the disabled appearance of the control by generating JavaScript code that alters the aspNetDisabled class. Esto funcionará como se esperaba si RenderingCompatibility es 4.0 o posterior.This will work as expected if RenderingCompatibility is 4.0 or later. Pero para obtener el mismo efecto cuando RenderingCompatibility es 3.5, código del control personalizado debe establecer el control CssClass propiedad en "aspNetDisabled" cuando la IsEnabled propiedad es false.But to get the same effect when RenderingCompatibility is 3.5, the custom control's code must set the control's CssClass property to "aspNetDisabled" when the IsEnabled property is false.

Se aplica a

Consulte también: