Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source

Control.RenderingCompatibility, propriété

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

Espace de noms :  System.Web.UI
Assembly :  System.Web (dans System.Web.dll)

[BindableAttribute(false)]
[BrowsableAttribute(false)]
public virtual Version RenderingCompatibility { get; set; }

Valeur de propriété

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

ASP.NET affecte à cette propriété 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 d'ASP.NET.

Remarque AttentionAttention

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. Si vous définissez cette valeur dans votre code, l'effet est imprévisible.

Chaque version d'ASP.NET peut restituer le HTML différemment des versions précédentes. Par exemple, dans ASP.NET 3.5, si la propriété IsEnabled d'un contrôle Label est false, par défaut, ASP.NET restitue un élément span dont l'attribut disabled est défini sur « désactivé ». Dans ASP.NET 4, par défaut, l'élément span est restitué avec un attribut class de feuille de style en cascade (CSS) au lieu de l'attribut disabled. Cela vous permet de spécifier l'apparence désactivée du contrôle et vous évite de restituer du code HTML non valide. (En 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 fonctionnerait 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 voulez maintenir la compatibilité. Par exemple, si vous affectez à la propriété RenderingCompatibility la valeur 3.5, un contrôle Label désactivé restituera un attribut disabled et non une classe CSS.

RemarqueRemarque

La version la plus récente que vous pouvez affecter à 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 affecte automatiquement à l'attribut controlRenderingCompatibilityVersion du fichier Web.config la valeur 3.5. Si vous souhaitez qu'un site Web mis à niveau restitue le code HTML à l'aide de l'algorithme qui été introduit dans ASP.NET 4, vous pouvez changer ou supprimer l'attribut controlRenderingCompatibilityVersion.

La plupart du temps, le comportement contrôlé par cette propriété est automatique et vous n'avez pas à vérifier la propriété RenderingCompatibility 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 selon le paramètre de cette propriété. Par exemple, un contrôle personnalisé pour ASP.NET 4 peut être composé de contrôles Label, et ce contrôle personnalisé peut spécifier l'apparence désactivée du contrôle en générant du code JavaScript qui modifie la classe aspNetDisabled. 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 affecter à la propriété CssClass du contrôle la valeur « aspNetDisabled » lorsque la propriété IsEnabled est false.

.NET Framework

Pris en charge dans : 4

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft