Control.RenderingCompatibility Propiedad

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.

Atributos

Comentarios

ASP.NET establece esta propiedad en el valor del atributo controlRenderingCompatibilityVersion del elemento pages 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 atributo controlRenderingCompatibilityVersion no se establece 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 set público para esta propiedad, pero el descriptor de acceso set admite la infraestructura de .NET Framework y no está diseñada 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 imprevisible.If you set this value in your code, the effect is unpredictable.

Cada versión de ASP.NET puede representar HTML de forma diferente de las versiones anteriores.Each release of ASP.NET might render HTML differently from earlier releases. Por ejemplo, en ASP.NET 3,5, si la propiedad IsEnabled de un control Label es false, de forma predeterminada, ASP.NET representa un elemento span cuyo atributo disabled se establece 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 elemento span se representa con un atributo class de hoja de estilos en cascada (CSS) en lugar del atributo disabled.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 deshabilitada del control 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 elemento span no admite el atributo disabled).(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 no funcionará correctamente si se produce un cambio de 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 atributo controlRenderingCompatibilityVersion del elemento pages en el archivo Web. config para indicar en qué versión anterior desea mantener la compatibilidad.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 propiedad RenderingCompatibility en 3.5, un control de Label deshabilitado representará un atributo disabled 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

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

Para mantener la compatibilidad con versiones anteriores, al usar Visual Studio para actualizar un proyecto web a ASP.NET 4 desde una versión anterior, Visual Studio establece automáticamente el atributo controlRenderingCompatibilityVersion del archivo Web. config en 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 represente HTML usando el algoritmo que se presentó en ASP.NET 4, puede cambiar o quitar el atributo controlRenderingCompatibilityVersion.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 las veces, el comportamiento controlado por esta propiedad es automático y no es necesario comprobar la propiedad RenderingCompatibility 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 tenga que incluir código que modifique el comportamiento del control en función de la configuración 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 compuesto de controles Label, y el control personalizado podría especificar la apariencia deshabilitada del control generando código JavaScript que modifica la clase aspNetDisabled.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á según lo esperado 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 se 3.5RenderingCompatibility, el código del control personalizado debe establecer la propiedad CssClass del control en "aspNetDisabled" cuando se falsela propiedad IsEnabled.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: