Control.RenderingCompatibility Control.RenderingCompatibility Control.RenderingCompatibility Control.RenderingCompatibility Property

Definizione

Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering.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

Valore della proprietà

La versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering.The ASP.NET version that rendered HTML will be compatible with.

Commenti

ASP.NET imposta questa proprietà sul valore dell' controlRenderingCompatibilityVersion attributo pages dell'elemento nel file Web. config.ASP.NET sets this property to the value of the controlRenderingCompatibilityVersion attribute of the pages element in the Web.config file. Se l' controlRenderingCompatibilityVersion attributo non è impostato nel file Web. config, il valore predefinito è la versione corrente di ASP.NET.If the controlRenderingCompatibilityVersion attribute is not set in the Web.config file, the default value is the current version of ASP.NET.

Attenzione

È disponibile una funzione di accesso set pubblica per questa proprietà, ma la funzione di accesso set supporta l'infrastruttura .NET Framework e non può essere usata direttamente dal codice.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. Se si imposta questo valore nel codice, l'effetto è imprevedibile.If you set this value in your code, the effect is unpredictable.

Ogni versione di ASP.NET potrebbe eseguire il rendering HTML in modo diverso rispetto alle versioni precedenti.Each release of ASP.NET might render HTML differently from earlier releases. Ad esempio, in ASP.NET 3,5, se la IsEnabled proprietà di un Label controllo è false, per impostazione predefinita, ASP.NET esegue il span rendering di disabled un elemento il cui attributo è impostato su "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". In ASP.NET 4, per impostazione predefinita, span viene eseguito il rendering dell'elemento con un class attributo CSS anziché l' disabled attributo.In ASP.NET 4, by default, the span element is rendered with a cascading style sheet (CSS) class attribute instead of the disabled attribute. In questo modo è possibile specificare l'aspetto disabilitato del controllo ed evitare il rendering del codice HTML non valido.This lets you specify the disabled appearance of the control and avoids rendering invalid HTML. (In HTML 4,0 e XHTML 1,1, l' span elemento non supporta l' disabled attributo).(In HTML 4.0 and XHTML 1.1, the span element does not support the disabled attribute.)

Un'applicazione Web può includere codice che non funzionerà correttamente se il rendering HTML viene modificato.A Web application might include code that would not function correctly if HTML rendering changes. Per evitare questo problema, è possibile impostare l' controlRenderingCompatibilityVersion attributo pages dell'elemento nel file Web. config per indicare quale versione precedente si desidera mantenere la compatibilità.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. Se, ad esempio, si imposta RenderingCompatibility la proprietà 3.5su, un Label controllo disabilitato eseguirà il rendering di un disabled attributo e non di una classe 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 versione meno recente della quale è possibile impostare questa proprietà è 3.5.The earliest version that you can set this property to is 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 controlRenderingCompatibilityVersion Studio imposta automaticamente l'attributo nel file Web 3.5. config su.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. Se si desidera che un sito Web aggiornato esegua il rendering del codice HTML utilizzando l'algoritmo introdotto in ASP.NET 4, è possibile modificare controlRenderingCompatibilityVersion o rimuovere l'attributo.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.

Nella maggior parte dei casi, il comportamento controllato da questa proprietà è automatico e non è necessario controllare la RenderingCompatibility proprietà nel codice.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. 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à.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. Ad esempio, un controllo personalizzato per ASP.NET 4 potrebbe essere composto Label da controlli e il controllo personalizzato potrebbe specificare l'aspetto disabilitato del controllo generando codice JavaScript che modifica la aspNetDisabled classe.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. Questa operazione funzionerà come previsto RenderingCompatibility se 4.0 è o versione successiva.This will work as expected if RenderingCompatibility is 4.0 or later. Tuttavia, per ottenere lo stesso effetto RenderingCompatibility quando 3.5è, il codice del controllo personalizzato CssClass deve impostare la proprietà del controllo su "aspNetDisabled" quando IsEnabled la proprietà falseè.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.

Si applica a

Vedi anche