Control.RenderingCompatibility Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá hodnotu, která určuje ASP.NET verzi, která vykreslený KÓD HTML bude kompatibilní s.
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 VersionHodnota vlastnosti
Verze ASP.NET, se kterou se vykresloval kód HTML, bude kompatibilní.
- Atributy
Poznámky
ASP.NET nastaví tuto vlastnost na hodnotu controlRenderingCompatibilityVersion atributu pages prvku v souboru Web.config.
controlRenderingCompatibilityVersion Pokud atribut není nastaven v souboru Web.config, výchozí hodnota je aktuální verze ASP.NET.
Upozornění
Pro tuto vlastnost je k dispozici přístupový objekt veřejné sady, ale přístupový objekt sady podporuje infrastrukturu rozhraní .NET Framework a není určen k použití přímo z vašeho kódu. Pokud tuto hodnotu nastavíte ve svém kódu, bude efekt nepředvídatelný.
Každá verze ASP.NET může vykreslit html jinak než v předchozích verzích. Například v ASP.NET 3.5 pokud IsEnabled je falsevlastnost Label ovládacího prvku ve výchozím nastavení, ASP.NET vykresluje span prvek, jehož disabled atribut je nastaven na "disabled". Ve výchozím nastavení span ASP.NET 4 se prvek vykresluje s atributem CSS (Cascading Style Sheet) class místo atributu disabled . Díky tomu můžete určit zakázaný vzhled ovládacího prvku a vyhnout se vykreslování neplatného kódu HTML. (V HTML 4.0 a XHTML 1.1 span prvek nepodporuje disabled atribut.)
Webová aplikace může obsahovat kód, který nebude správně fungovat, pokud se změny vykreslování HTML změní. Chcete-li se tomuto problému vyhnout, můžete nastavit controlRenderingCompatibilityVersion atribut pages elementu v souboru Web.config, který označuje, která starší verze chcete zachovat kompatibilitu. Pokud například nastavíte RenderingCompatibility vlastnost na 3.5, zakázaný Label ovládací prvek vykresluje disabled atribut, nikoli třídu CSS.
Poznámka:
Nejstarší verze, na kterou můžete tuto vlastnost nastavit, je 3.5.
Chcete-li zachovat zpětnou kompatibilitu, 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. Pokud chcete, aby upgradovaný web vykresloval kód HTML pomocí algoritmu, který byl zaveden v ASP.NET 4, můžete atribut změnit nebo odebrat controlRenderingCompatibilityVersion .
Ve většině případů je chování řízené touto vlastností automatické a není nutné zkontrolovat RenderingCompatibility vlastnost v kódu. Pokud ale naprogramujete vlastní ovládací prvek, budete pravděpodobně muset zahrnout kód, který mění chování ovládacího prvku na základě nastavení této vlastnosti. Například vlastní ovládací prvek pro ASP.NET 4 se může skládat z ovládacích Label prvků a vlastní ovládací prvek může určit zakázaný vzhled ovládacího prvku generováním javascriptového kódu, který mění aspNetDisabled třídu. To bude fungovat podle očekávání, pokud RenderingCompatibility je 4.0 nebo později. Chcete-li však získat stejný účinek, pokud RenderingCompatibility je 3.5, kód vlastního ovládacího prvku musí nastavit vlastnost ovládacího prvku CssClass na "aspNetDisabled", pokud IsEnabled je falsevlastnost .
