Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering.
Assembly: System.Web (in System.Web.dll)
<BindableAttribute(False)> _ <BrowsableAttribute(False)> _ Public Overridable Property RenderingCompatibility As Version Get Set
[BindableAttribute(false)] [BrowsableAttribute(false)] public virtual Version RenderingCompatibility { get; set; }
[BindableAttribute(false)] [BrowsableAttribute(false)] public: virtual property Version^ RenderingCompatibility { Version^ get (); void set (Version^ value); }
[<BindableAttribute(false)>] [<BrowsableAttribute(false)>] abstract RenderingCompatibility : Version with get, set [<BindableAttribute(false)>] [<BrowsableAttribute(false)>] override RenderingCompatibility : Version with get, set
Valore proprietà
Tipo: System.VersionLa versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering.
ASP.NET imposta questa proprietà sul valore dell'attributo controlRenderingCompatibilityVersion dell'elemento pages nel file Web.config. Se l'attributo controlRenderingCompatibilityVersion non è impostato nel file Web.config, il valore predefinito è la versione corrente di ASP.NET.
Attenzione
|
|---|
|
Esiste una funzione di accesso set pubblica per questa proprietà, tuttavia tale funzione di accesso set supporta l'infrastruttura .NET Framework e non è destinata a essere utilizzata direttamente dal codice. Se si imposta questo valore nel codice, l'effetto è imprevedibile. |
Ogni versione di ASP.NET potrebbe eseguire il rendering del codice HTML in modo diverso dalle versioni precedenti. In ASP.NET 3.5, ad esempio, se la proprietà IsEnabled di un controllo Label è false, per impostazione predefinita ASP.NET esegue il rendering dell'elemento span il cui attributo disabled viene impostato sui "disabilitato". In ASP.NET 4, per impostazione predefinita, viene eseguito il rendering dell'elemento span con un attributo class di foglio di stile CSS anziché l'attributo disabled. Consente di specificare l'aspetto del controllo disabilitato ed evita di eseguire il rendering di HTML non valido. In HTML 4.0 e XHTML 1.1 l'elemento span non supporta l'attributo disabled.
Un'applicazione Web potrebbe includere del codice che non sarebbe in grado di funzionare correttamente se il rendering HTML venisse modificato. Per evitare questo problema, è possibile impostare l'attributo controlRenderingCompatibilityVersion dell'elemento pages nel file Web.config per indicare con quale versione precedente si desidera conservare la compatibilità. Ad esempio, se si imposta la proprietà RenderingCompatibility su 3.5, un controllo Label disabilitato eseguirà il rendering dell'attributo disabled e non di una classe CSS.
Nota
|
|---|
|
La versione meno recente sulla quale è possibile impostare questa proprietà è 3.5. |
Per conservare la compatibilità con le versioni precedenti, quando si utilizza Visual Studio per aggiornare un progetto Web da una versione precedente alla versione ASP.NET 4, Visual Studio imposta automaticamente l'attributo controlRenderingCompatibilityVersion nel file Web.config su 3.5. Se si desidera che un sito Web aggiornato esegua il rendering di HTML utilizzando l'algoritmo introdotto in ASP.NET 4, è possibile modificare o rimuovere l'attributo controlRenderingCompatibilityVersion.
La maggior parte delle volte, il comportamento controllato da questa proprietà è automatico e non è necessario archiviare la proprietà RenderingCompatibility nel codice. Tuttavia, se si programma un controllo personalizzato, potrebbe essere necessario includere del codice che modifica il comportamento del controllo basato sull'impostazione di questa proprietà. Ad esempio, un controllo personalizzato per ASP.NET 4 potrebbe essere composto da controlli Label, mentre il controllo personalizzato potrebbe specificare l'aspetto disabilitato del controllo generando del codice JavaScript che modifica la classe aspNetDisabled. Questo funzionerà come previsto se la proprietà RenderingCompatibility è impostata su 4.0 o versioni successive. Tuttavia, per ottenere lo stesso effetto quando RenderingCompatibility è 3.5, il codice del controllo personalizzato deve impostare la proprietà CssClass del controllo su "aspNetDisabled" quando la proprietà IsEnabled è false.
.NET Framework
Supportato in: 4Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2
.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.