Control.RenderingCompatibility Vlastnost

Definice

Získá hodnotu, která určuje verzi ASP.NET, s jakou bude HTML vykresleno kompatibilní.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; }
[<System.ComponentModel.Bindable(false)>]
[<System.ComponentModel.Browsable(false)>]
member this.RenderingCompatibility : Version with get, set
Public Overridable Property RenderingCompatibility As Version

Hodnota vlastnosti

Version

Verze ASP.NET vykreslování HTML bude kompatibilní s.The ASP.NET version that rendered HTML will be compatible with.

Atributy

Poznámky

ASP.NET nastaví tuto vlastnost na hodnotu controlRenderingCompatibilityVersion atributu pages elementu v souboru Web.config.ASP.NET sets this property to the value of the controlRenderingCompatibilityVersion attribute of the pages element in the Web.config file. Pokud controlRenderingCompatibilityVersion atribut není nastaven v Web.config souboru, výchozí hodnota je aktuální verze ASP.NET.If the controlRenderingCompatibilityVersion attribute is not set in the Web.config file, the default value is the current version of ASP.NET.

Upozornění

Pro tuto vlastnost je k dispozici přístupový objekt veřejné sady, ale přístupový objekt set podporuje infrastrukturu .NET Framework a není určen pro použití přímo v kódu.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. Pokud nastavíte tuto hodnotu v kódu, efekt je nepředvídatelné.If you set this value in your code, the effect is unpredictable.

Každé vydání ASP.NET může HTML vykreslovat jinak než v předchozích verzích.Each release of ASP.NET might render HTML differently from earlier releases. Například v ASP.NET 3,5, pokud IsEnabled Label je vlastnost ovládacího prvku false ve výchozím nastavení, ASP.NET vykreslí span prvek, jehož disabled atribut je nastaven na hodnotu "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". Ve výchozím nastavení je element v ASP.NET 4 span vykreslen pomocí atributu CSS (Cascading Style Sheet) class namísto disabled atributu.In ASP.NET 4, by default, the span element is rendered with a cascading style sheet (CSS) class attribute instead of the disabled attribute. To vám umožní určit zakázaný vzhled ovládacího prvku a vyhnout se vykreslování neplatného HTML.This lets you specify the disabled appearance of the control and avoids rendering invalid HTML. (V HTML 4,0 a XHTML 1,1 element nepodporuje span disabled atribut.)(In HTML 4.0 and XHTML 1.1, the span element does not support the disabled attribute.)

Webová aplikace může obsahovat kód, který nebude správně fungovat, pokud se změní vykreslování HTML.A Web application might include code that would not function correctly if HTML rendering changes. Chcete-li se tomuto problému vyhnout, můžete nastavit controlRenderingCompatibilityVersion atribut pages prvku v souboru Web.config tak, aby označoval, u kterého starší verze chcete zachovat kompatibilitu.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. Například pokud nastavíte RenderingCompatibility vlastnost na 3.5 , zakázaný Label ovládací prvek bude vykreslovat atribut, disabled nikoli Třída 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.

Poznámka

Nejstarší verze, na kterou můžete nastavit tuto vlastnost 3.5 .The earliest version that you can set this property to is 3.5.

Aby se zachovala zpětná kompatibilita, při použití sady Visual Studio k upgradu webového projektu na ASP.NET 4 ze starší verze sada Visual Studio automaticky nastaví controlRenderingCompatibilityVersion atribut v souboru Web.config na 3.5 .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. Pokud chcete, aby upgradovaný web vykreslil kód HTML pomocí algoritmu, který byl představen v ASP.NET 4, můžete změnit nebo odebrat controlRenderingCompatibilityVersion atribut.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.

Většinou je chování kontrolované touto vlastností automaticky a není nutné kontrolovat RenderingCompatibility vlastnost v kódu.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. Nicméně Pokud programujete vlastní ovládací prvek, bude pravděpodobně nutné zahrnout kód, který změní chování ovládacího prvku na základě nastavení této vlastnosti.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. Například vlastní ovládací prvek pro ASP.NET 4 může být tvořen Label ovládacími prvky a vlastní ovládací prvek může určit zakázaný vzhled ovládacího prvku generováním kódu jazyka JavaScript, který mění aspNetDisabled třídu.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. To bude fungovat podle očekávání, pokud RenderingCompatibility je 4.0 nebo novější.This will work as expected if RenderingCompatibility is 4.0 or later. Ale chcete-li získat stejný efekt RenderingCompatibility , pokud je 3.5 , kód vlastního ovládacího prvku musí nastavit vlastnost ovládacího prvku CssClass na "aspNetDisabled", pokud IsEnabled je vlastnost nastavena na hodnotu "" 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.

Platí pro

Viz také