Exportar (0) Imprimir
Expandir todo
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

Control.RenderingCompatibility (Propiedad)

Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados.

Espacio de nombres:  System.Web.UI
Ensamblado:  System.Web (en System.Web.dll)

[BindableAttribute(false)]
[BrowsableAttribute(false)]
public virtual Version RenderingCompatibility { get; set; }

Valor de propiedad

Tipo: System.Version
Versión de ASP.NET compatible con los elementos HTML representados.

ASP.NET establece esta propiedad en el valor del atributo controlRenderingCompatibilityVersion del elemento pages del archivos Web.config. Si el atributo controlRenderingCompatibilityVersion no está establecido en el archivo Web.config, el valor predeterminado es la versión actual de ASP.NET.

Nota de precauciónPrecaució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á pensado para utilizarse directamente desde el código. Si establece este valor en su código, el efecto es impredecible.

Cada lanzamiento de ASP.NET podría representar de manera diferente HTML con respecto a las versiones anteriores. 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 "deshabilitado". 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. Esto permite especificar el aspecto deshabilitado del control y evita la representación de HTML no válido. (En HTML 4.0 y XHTML 1.1, el elemento span no es compatible con el atributo disabled.)

Una aplicación web podría incluir código que no funcionaría correctamente si la representación de HTML cambia. Para evitar este problema, puede establecer el atributo controlRenderingCompatibilityVersion del elemento pages en el archivo Web.config y, de esta forma, indicar con qué versión anterior desea mantener la compatibilidad. Por ejemplo, si establece la propiedad RenderingCompatibility en 3.5, un control Label deshabilitado representará un atributo disabled y no una clase CSS.

NotaNota

La versión anterior en la que puede establecer esta propiedad es 3.5.

Para mantener la compatibilidad con versiones anteriores, cuando use Visual Studio para actualizar un proyecto web a ASP.NET 4 desde una versión anterior, Visual Studio establece automáticamente el atributo controlRenderingCompatibilityVersion en el archivo Web.config en 3.5. Si desea que un sitio web actualizado represente HTML mediante el algoritmo introducido en ASP.NET 4, puede cambiar o quitar el atributo controlRenderingCompatibilityVersion.

En la mayoría de los casos, el comportamiento controlado por esta propiedad es automático y no tiene que comprobar la propiedad RenderingCompatibility en su código. Sin embargo, si está programando un control personalizado, podría tener que incluir el código que modifica el comportamiento del control basado en el valor de esta propiedad. Por ejemplo, un control personalizado para ASP.NET 4 podría estar compuesto por controles Label y el control personalizado podría especificar el aspecto deshabilitado del control generando código JavaScript que modifica la clase aspNetDisabled. Esto funcionará del modo esperado si RenderingCompatibility es 4.0 o posterior. Pero para obtener el mismo efecto cuando RenderingCompatibility es 3.5, el código de control personalizado debe establecer la propiedad CssClass del control en "aspNetDisabled" cuando la propiedad IsEnabled es false.

.NET Framework

Compatible con: 4

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft