Control.RenderingCompatibility Control.RenderingCompatibility Control.RenderingCompatibility Control.RenderingCompatibility Property

Définition

Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible.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; }
member this.RenderingCompatibility : Version with get, set
Public Overridable Property RenderingCompatibility As Version

Valeur de propriété

Version ASP.NET avec laquelle le HTML restitué sera compatible.The ASP.NET version that rendered HTML will be compatible with.

Remarques

ASP.net définit cette propriété sur la valeur de l' controlRenderingCompatibilityVersion attribut de l' pages élément dans le fichier Web. config.ASP.NET sets this property to the value of the controlRenderingCompatibilityVersion attribute of the pages element in the Web.config file. Si l' controlRenderingCompatibilityVersion attribut n’est pas défini dans le fichier Web. config, la valeur par défaut est la version actuelle de ASP.net.If the controlRenderingCompatibilityVersion attribute is not set in the Web.config file, the default value is the current version of ASP.NET.

Attention

Il existe un accesseur Set public pour cette propriété, mais l’accesseur set prend en charge l’infrastructure .NET Framework et n’est pas destiné à être utilisé directement à partir de votre code.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. Si vous définissez cette valeur dans votre code, l’effet est imprévisible.If you set this value in your code, the effect is unpredictable.

Chaque version de ASP.NET peut restituer le HTML différemment des versions antérieures.Each release of ASP.NET might render HTML differently from earlier releases. Par exemple, dans ASP.net 3,5, si la IsEnabled propriété d’un Label contrôle est false, par défaut, ASP.NET restitue un span élément dont disabled l’attribut a la valeur « 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". Dans ASP.net 4, par défaut, l' span élément est rendu avec un attribut de feuille de style en cascade class (CSS) à disabled la place de l’attribut.In ASP.NET 4, by default, the span element is rendered with a cascading style sheet (CSS) class attribute instead of the disabled attribute. Cela vous permet de spécifier l’apparence désactivée du contrôle et d’éviter le rendu de code HTML non valide.This lets you specify the disabled appearance of the control and avoids rendering invalid HTML. (En HTML 4,0 et XHTML 1,1, l' span élément ne prend pas en disabled charge l’attribut.)(In HTML 4.0 and XHTML 1.1, the span element does not support the disabled attribute.)

Une application Web peut inclure du code qui ne fonctionnerait pas correctement si le rendu HTML change.A Web application might include code that would not function correctly if HTML rendering changes. Pour éviter ce problème, vous pouvez définir l' controlRenderingCompatibilityVersion attribut de l' pages élément dans le fichier Web. config pour indiquer la version antérieure avec laquelle vous souhaitez maintenir la compatibilité.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. Par exemple, si vous affectez RenderingCompatibility à 3.5la propriété la valeur Label , un contrôle désactivé disabled affiche un attribut et non une classe 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.

Notes

La première version que vous pouvez affecter à cette propriété est 3.5.The earliest version that you can set this property to is 3.5.

Pour assurer la compatibilité descendante, lorsque vous utilisez Visual Studio pour mettre à niveau un projet Web vers ASP.net 4 à partir d’une version antérieure controlRenderingCompatibilityVersion , Visual Studio affecte automatiquement à l’attribut 3.5dans le fichier Web. config la valeur.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. Si vous souhaitez qu’un site Web mis à niveau restitue le code HTML à l’aide de l’algorithme introduit dans ASP.net 4, vous controlRenderingCompatibilityVersion pouvez modifier ou supprimer l’attribut.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.

La plupart du temps, le comportement contrôlé par cette propriété est automatique et vous n’avez pas besoin de vérifier RenderingCompatibility la propriété dans votre code.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. Toutefois, si vous programmez un contrôle personnalisé, vous devrez peut-être inclure du code qui modifie le comportement du contrôle en fonction de la valeur de cette propriété.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. Par exemple, un contrôle personnalisé pour ASP.net 4 peut être composé de Label contrôles, et le contrôle personnalisé peut spécifier l’apparence désactivée du contrôle en générant du code JavaScript qui aspNetDisabled modifie la classe.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. Cela fonctionnera comme prévu si RenderingCompatibility est 4.0 ou une version ultérieure.This will work as expected if RenderingCompatibility is 4.0 or later. Mais pour avoir le même effet lorsque RenderingCompatibility est 3.5, le code du contrôle personnalisé doit définir la propriété du CssClass contrôle sur « aspNetDisabled » lorsque la IsEnabled propriété a falsela valeur.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.

S’applique à

Voir aussi