Control.RenderingCompatibility Propriété

Définition

Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible.

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

Valeur de propriété

Version ASP.NET avec laquelle le HTML restitué sera compatible.

Attributs

Remarques

ASP.NET définit cette propriété sur la valeur de l’attribut controlRenderingCompatibilityVersion de l’élément pages dans le fichier Web.config. Si l’attribut controlRenderingCompatibilityVersion n’est pas défini dans le fichier Web.config, la valeur par défaut est la version actuelle de ASP.NET.

Attention

Il existe un accesseur de jeu 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. Si vous définissez cette valeur dans votre code, l’effet est imprévisible.

Chaque version de ASP.NET peut afficher le code HTML différemment des versions antérieures. 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 est défini sur « disabled ». Dans ASP.NET 4, par défaut, l’élément span est rendu avec un attribut de feuille de style en cascade (CSS) class au lieu de l’attribut disabled . Cela vous permet de spécifier l’apparence désactivée du contrôle et d’éviter le rendu du code HTML non valide. (Dans HTML 4.0 et XHTML 1.1, l’élément span ne prend pas en charge l’attribut disabled .)

Une application web peut inclure du code qui ne fonctionne pas correctement si le rendu HTML change. Pour éviter ce problème, vous pouvez définir l’attribut controlRenderingCompatibilityVersion de l’élément pages dans le fichier Web.config pour indiquer la version antérieure avec laquelle vous souhaitez maintenir la compatibilité. Par exemple, si vous définissez la propriété sur RenderingCompatibility3.5, un contrôle désactivé Label affiche un disabled attribut et non une classe CSS.

Notes

La version la plus ancienne sur laquelle vous pouvez définir cette propriété est 3.5.

Pour maintenir la compatibilité descendante, lorsque vous utilisez Visual Studio pour mettre à niveau un projet web vers ASP.NET 4 à partir d’une version antérieure, Visual Studio définit automatiquement l’attribut controlRenderingCompatibilityVersion dans le fichier Web.config sur 3.5. Si vous souhaitez qu’un site Web mis à niveau affiche le code HTML à l’aide de l’algorithme introduit dans ASP.NET 4, vous pouvez modifier ou supprimer l’attribut controlRenderingCompatibilityVersion .

La plupart du temps, le comportement contrôlé par cette propriété est automatique et vous n’avez pas besoin de vérifier la RenderingCompatibility propriété dans votre 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 du paramètre de cette propriété. 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 modifie la aspNetDisabled classe. Cela fonctionnera comme prévu si RenderingCompatibility est 4.0 ou version ultérieure. Mais pour obtenir 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 propriété a la IsEnabled valeur false.

S’applique à

Voir aussi