Control.RenderingCompatibility Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar ett värde som anger den ASP.NET version som renderad HTML kommer att vara kompatibel med.
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 VersionEgenskapsvärde
Den ASP.NET version som renderade HTML är kompatibel med.
- Attribut
Kommentarer
ASP.NET anger den här egenskapen till värdet för attributet controlRenderingCompatibilityVersion för elementet pages i Web.config-filen. Om attributet controlRenderingCompatibilityVersion inte anges i filen Web.config är standardvärdet den aktuella versionen av ASP.NET.
Caution
Det finns en offentlig uppsättningsåtkomst för den här egenskapen, men set-åtkomstorn stöder .NET Framework-infrastrukturen och är inte avsedd att användas direkt från koden. Om du anger det här värdet i koden är effekten oförutsägbar.
Varje version av ASP.NET kan återge HTML annorlunda än tidigare versioner. Om egenskapen IsEnabled för en Label-kontroll till ASP.NET exempel är false renderar ASP.NET som standard ett span element vars attribut disabled är inställt på "inaktiverad". I ASP.NET 4 återges elementet span som standard med ett CSS-class-attribut i stället för attributet disabled. På så sätt kan du ange kontrollens inaktiverade utseende och undvika att återge ogiltig HTML. (I HTML 4.0 och XHTML 1.1 stöder span elementet disabled inte attributet.)
Ett webbprogram kan innehålla kod som inte fungerar korrekt om HTML-återgivningen ändras. För att undvika det här problemet kan du ange controlRenderingCompatibilityVersion attributet för elementet pages i Web.config-filen för att ange vilken tidigare version du vill behålla kompatibiliteten med. Om du till exempel anger RenderingCompatibility egenskapen till 3.5renderar en inaktiverad Label kontroll ett disabled attribut och inte en CSS-klass.
Note
Den tidigaste versionen som du kan ange den här egenskapen till är 3.5.
Om du vill behålla bakåtkompatibiliteten anger Visual Studio automatiskt attributet controlRenderingCompatibilityVersion i Web.config-filen till 3.5 när du använder Visual Studio för att uppgradera ett webbprojekt till ASP.NET 4 från en tidigare version. Om du vill att en uppgraderad webbplats ska återge HTML med hjälp av algoritmen som introducerades i ASP.NET 4 kan du ändra eller ta bort attributet controlRenderingCompatibilityVersion.
För det mesta är beteendet som styrs av den här egenskapen automatiskt och du behöver inte kontrollera RenderingCompatibility egenskapen i koden. Men om du programmerar en anpassad kontroll kan du behöva inkludera kod som ändrar kontrollens beteende baserat på inställningen för den här egenskapen. En anpassad kontroll för ASP.NET 4 kan till exempel bestå av Label kontroller, och den anpassade kontrollen kan ange kontrollens inaktiverade utseende genom att generera JavaScript-kod som ändrar klassen aspNetDisabled. Detta fungerar som förväntat om RenderingCompatibility det är 4.0 eller senare. Men för att få samma effekt när RenderingCompatibility är 3.5måste den anpassade kontrollens kod ange kontrollens CssClass egenskap till "aspNetDisabled" när IsEnabled egenskapen är false.
