Control.RenderingCompatibility Tulajdonság

Definíció

Névtér:

System.Web.UI

Szerelvény:

System.Web.dll

Olyan értéket kap, amely meghatározza, hogy a HTML-renderelt ASP.NET verzió kompatibilis lesz-e.

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

Tulajdonság értéke

Version

A HTML-t megjelenítő ASP.NET verzió kompatibilis lesz.

Attribútumok

BindableAttribute BrowsableAttribute

Megjegyzések

ASP.NET ezt a tulajdonságot a Web.config fájl controlRenderingCompatibilityVersion elemének pages attribútumának értékére állítja. Ha a controlRenderingCompatibilityVersion attribútum nincs beállítva a Web.config fájlban, az alapértelmezett érték a ASP.NET aktuális verziója.

Figyelmeztetés

Ehhez a tulajdonsághoz tartozik egy nyilvános készletkiegészítő, de a készlet tartozéka támogatja a .NET-keretrendszer infrastruktúráját, és nem közvetlenül a kódból való használatra szolgál. Ha ezt az értéket a kódban állítja be, az effektus kiszámíthatatlan.

A ASP.NET minden egyes kiadása eltérően jelenítheti meg a HTML-t a korábbi kiadásoktól. Ha például a 3.5-ös ASP.NET egy IsEnabled vezérlőelem Label tulajdonsága false, alapértelmezés szerint ASP.NET egy span elemet jelenít meg, amelynek disabled attribútuma "letiltva" értékre van állítva. A 4. ASP.NET alapértelmezés szerint a span elem a class attribútum helyett egy kaszkádolt stíluslappal (CSS) disabled attribútummal jelenik meg. Ezzel megadhatja a vezérlő letiltott megjelenését, és elkerülheti az érvénytelen HTML-kód megjelenítését. (A HTML 4.0 és az XHTML 1.1 esetében az span elem nem támogatja az disabled attribútumot.)

A webalkalmazások tartalmazhatnak olyan kódot, amely nem működik megfelelően, ha a HTML-renderelés megváltozik. A probléma elkerülése érdekében beállíthatja az controlRenderingCompatibilityVersion elem attribútumát a pages Web.config fájlban, hogy jelezze, melyik korábbi verzióval szeretné fenntartani a kompatibilitást. Ha például a tulajdonságot úgy állítja be, hogy egy RenderingCompatibility letiltott 3.5 vezérlőelem nem CSS-osztályt, hanem attribútumot jelenít megLabel.disabled

Note

A tulajdonságot 3.5a legkorábbi verzióra állíthatja be.

A visszamenőleges kompatibilitás fenntartása érdekében, ha a Visual Studio használatával frissít egy webes projektet egy korábbi verzióból ASP.NET 4-re, Visual Studio automatikusan controlRenderingCompatibilityVersion értékre állítja a Web.config fájlban lévő 3.5 attribútumot. Ha azt szeretné, hogy egy frissített webhely a 4. ASP.NET bevezetett algoritmussal renderelje a HTML-t, módosíthatja vagy eltávolíthatja a controlRenderingCompatibilityVersion attribútumot.

A tulajdonság által szabályozott viselkedés legtöbbször automatikus, és nem kell ellenőriznie a tulajdonságot a RenderingCompatibility kódban. Ha azonban egyéni vezérlőt programoz, előfordulhat, hogy olyan kódot kell tartalmaznia, amely a tulajdonság beállítása alapján módosítja a vezérlő viselkedését. A 4. ASP.NET egyéni vezérlője például Label vezérlőkből állhat, az egyéni vezérlő pedig a aspNetDisabled osztályt módosító JavaScript-kód generálásával határozhatja meg a vezérlő letiltott megjelenését. Ez a várt módon fog működni, ha RenderingCompatibility van 4.0 vagy újabb. Ha azonban ugyanazt a hatást szeretné elérni, akkor RenderingCompatibility3.5az egyéni vezérlő kódjának "aspNetDisabled" értékre kell állítania a vezérlő tulajdonságátCssClass, amikor a IsEnabled tulajdonság értéke .false

Lásd még

• ControlRenderingCompatibilityVersion