Control.RenderingCompatibility Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering.
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 VersionValore della proprietà
La versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering.
- Attributi
Commenti
ASP.NET imposta questa proprietà sul valore dell'attributo dell'elemento controlRenderingCompatibilityVersionpages nel file di Web.config. Se l'attributo controlRenderingCompatibilityVersion non è impostato nel file Web.config, il valore predefinito è la versione corrente di ASP.NET.
Attenzione
Per questa proprietà è disponibile una funzione di accesso del set pubblico, ma la funzione di accesso set supporta l'infrastruttura .NET Framework e non deve essere usata direttamente dal codice. Se si imposta questo valore nel codice, l'effetto è imprevedibile.
Ogni versione di ASP.NET potrebbe eseguire il rendering di HTML in modo diverso dalle versioni precedenti. Ad esempio, in ASP.NET 3.5, se la proprietà di un controllo è , per impostazione predefinita, ASP.NET esegue il rendering di un Labelspan elemento il IsEnabled cui disabled attributo è falseimpostato su "disabilitato". In ASP.NET 4, per impostazione predefinita, l'elemento viene eseguito il span rendering con un attributo css (Cascading Style Sheet) class anziché l'attributo disabled . In questo modo è possibile specificare l'aspetto disabilitato del controllo ed evitare 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 codice che non funzionerebbe correttamente se il rendering HTML cambia. Per evitare questo problema, è possibile impostare l'attributo dell'elemento controlRenderingCompatibilityVersionpages nel file Web.config per indicare la versione precedente con cui si vuole mantenere la compatibilità. Ad esempio, se si imposta la proprietà su 3.5, un controllo disabilitato Label eseguirà il RenderingCompatibility rendering di un disabled attributo e non di una classe CSS.
Nota
La versione più recente su cui è possibile impostare questa proprietà è 3.5.
Per mantenere la compatibilità con le versioni precedenti, quando si usa Visual Studio per aggiornare un progetto Web a ASP.NET 4 da una versione precedente, Visual Studio imposta automaticamente l'attributo controlRenderingCompatibilityVersion nel file Web.config su 3.5. Se si vuole che un sito Web aggiornato venga eseguito il rendering di HTML usando l'algoritmo introdotto in ASP.NET 4, è possibile modificare o rimuovere l'attributo controlRenderingCompatibilityVersion .
La maggior parte del tempo, il comportamento controllato da questa proprietà è automatico e non è necessario controllare la RenderingCompatibility proprietà nel codice. Tuttavia, se si sta programmando un controllo personalizzato, potrebbe essere necessario includere il codice che modifica il comportamento del controllo in base all'impostazione di questa proprietà. Ad esempio, un controllo personalizzato per ASP.NET 4 può essere composto da Label controlli e il controllo personalizzato potrebbe specificare l'aspetto disabilitato del controllo generando codice JavaScript che modifica la aspNetDisabled classe. Questo funzionerà come previsto se RenderingCompatibility è 4.0 o versioni successive. Tuttavia, per ottenere lo stesso effetto quando RenderingCompatibility è 3.5, il codice del controllo personalizzato deve impostare la proprietà del CssClass controllo su "aspNetDisabled" quando la IsEnabled proprietà è false.
