Control.RenderingCompatibility Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível.
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; }[<System.ComponentModel.Bindable(false)>]
[<System.ComponentModel.Browsable(false)>]
member this.RenderingCompatibility : Version with get, setPublic Overridable Property RenderingCompatibility As VersionValor de Propriedade
A versão ASP.NET que renderizou HTML será compatível.
- Atributos
Observações
ASP.NET define esta propriedade para o valor do atributo controlRenderingCompatibilityVersion do elemento pages no ficheiro Web.config. Se o atributo controlRenderingCompatibilityVersion não estiver definido no ficheiro Web.config, o valor padrão é a versão atual de ASP.NET.
Caution
Existe um acessório público de conjunto para esta propriedade, mas o acessório de conjunto suporta a infraestrutura do .NET Framework e não é destinado a ser usado diretamente a partir do seu código. Se definires este valor no teu código, o efeito é imprevisível.
Cada versão do ASP.NET pode renderizar HTML de forma diferente das versões anteriores. Por exemplo, no ASP.NET 3.5, se a propriedade IsEnabled de um controlo Label for false, por defeito, ASP.NET renderiza um elemento span cujo atributo disabled está definido como "desabilitado". No ASP.NET 4, por defeito, o elemento span é renderizado com um atributo de folha de estilo em cascata (CSS) class em vez do atributo disabled. Isto permite especificar a aparência desativada do controlo e evita que o HTML seja inválido. (No HTML 4.0 e XHTML 1.1, o span elemento não suporta o disabled atributo.)
Uma aplicação Web pode incluir código que não funcionaria corretamente se a renderização HTML for alterada. Para evitar este problema, podes definir o controlRenderingCompatibilityVersion atributo do pages elemento no ficheiro Web.config para indicar com qual versão anterior queres manter compatibilidade. Por exemplo, se definir a RenderingCompatibility propriedade para 3.5, um controlo desativado Label irá renderizar um disabled atributo e não uma classe CSS.
Note
A versão mais antiga que pode definir para esta propriedade é 3.5.
Para manter a retrocompatibilidade, quando usa Visual Studio para atualizar um projeto Web para ASP.NET 4 a partir de uma versão anterior, Visual Studio define automaticamente o atributo controlRenderingCompatibilityVersion no ficheiro Web.config para 3.5. Se quiser um site atualizado para renderizar HTML usando o algoritmo introduzido em ASP.NET 4, pode alterar ou remover o atributo controlRenderingCompatibilityVersion.
Na maioria das vezes, o comportamento controlado por esta propriedade é automático e não precisa de verificar a RenderingCompatibility propriedade no seu código. No entanto, se estiver a programar um controlo personalizado, poderá ter de incluir código que altere o comportamento do controlo com base na definição dessa propriedade. Por exemplo, um controlo personalizado para ASP.NET 4 pode ser composto por controlos Label, e o controlo personalizado pode especificar a aparência desativada do controlo gerando código JavaScript que altera a classe aspNetDisabled. Isto funcionará como esperado se RenderingCompatibility for 4.0 ou mais tarde. Mas para obter o mesmo efeito quando RenderingCompatibility é , o código do controlo personalizado tem de definir a propriedade do CssClass controlo para "aspNetDisabled" quando a IsEnabled propriedade é false3.5.