Control.RenderingCompatibility Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI
Sestavení:
System.Web.dll

Získá hodnotu, která určuje ASP.NET verze, která vykreslí 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, set
Public Overridable Property RenderingCompatibility As Version

Hodnota vlastnosti

Version

Verze ASP.NET, která vykreslovala HTML, bude kompatibilní s.

Atributy
BindableAttribute BrowsableAttribute

Poznámky

ASP.NET nastaví tuto vlastnost na hodnotu controlRenderingCompatibilityVersion atributu elementu pages v souboru Web.config. controlRenderingCompatibilityVersion Pokud atribut není v souboru Web.config nastaven, je výchozí hodnotou aktuální verze ASP.NET.

Upozornění

Pro tuto vlastnost existuje příslušenství veřejné sady, ale příslušenství sady podporuje infrastrukturu rozhraní .NET Framework a není určeno k použití přímo z vašeho kódu. Pokud tuto hodnotu nastavíte v kódu, bude efekt nepředvídatelný.

Každá verze ASP.NET může vykreslit HTML jinak než předchozí verze. Například v ASP.NET 3.5, pokud IsEnabled je falsevlastnost Label ovládacího prvku ve výchozím nastavení , ASP.NET vykreslí span prvek, jehož disabled atribut je nastaven na "zakázáno". V ASP.NET 4 se element ve výchozím nastavení span vykresluje pomocí atributu css (CSS) class namísto atributu disabled . To vám umožní 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 element nepodporuje disabled atribut.)

Webová aplikace může obsahovat kód, který nebude správně fungovat, pokud se změní vykreslování HTML. Chcete-li se vyhnout tomuto problému, můžete nastavit controlRenderingCompatibilityVersion atribut elementu pages v souboru Web.config tak, aby bylo možné určit, se kterou starší verzí chcete zachovat kompatibilitu. Pokud například nastavíte RenderingCompatibility vlastnost na 3.5, zakázaný Label ovládací prvek vykreslí disabled atribut, nikoli třídu CSS.

Poznámka

Nejstarší verze, kterou můžete nastavit na tuto vlastnost, je 3.5.

Za účelem zajištění zpětné kompatibility sada Visual Studio při upgradu webového projektu na ASP.NET 4 ze starší verze sada Visual Studio automaticky nastaví controlRenderingCompatibilityVersion atribut v souboru Web.config na 3.5hodnotu . Pokud chcete, aby upgradovaný web vykresloval 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 nemusíte kontrolovat RenderingCompatibility vlastnost v kódu. Pokud však programujete vlastní ovládací prvek, možná budete muset zahrnout kód, který změ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 kódu JavaScript, který mění aspNetDisabled třídu. Pokud je 4.0 nebo později, bude to fungovat podle očekáváníRenderingCompatibility. Chcete-li však získat stejný efekt, když 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 .

Platí pro

Viz také