Cette documentation est archivée et n’est pas conservée.

ThemeableAttribute, classe

Définit l'attribut de métadonnées utilisé par les contrôles serveur Web et leurs membres pour indiquer si leur rendu peut ou non être affecté par des thèmes et des apparences de contrôle. Cette classe ne peut pas être héritée.

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

[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Property)] 
public sealed class ThemeableAttribute : Attribute
/** @attribute AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Property) */ 
public final class ThemeableAttribute extends Attribute
AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Property) 
public final class ThemeableAttribute extends Attribute
Non applicable.

Les développeurs de contrôles utilisent l'attribut ThemeableAttribute pour décorer des types de contrôle et leurs membres, signaler ceux qui sont susceptibles ou non d'être affectés par des thèmes et des apparences de contrôle. Par défaut, toutes les propriétés d'un contrôle peuvent avoir un thème. Toutefois, des thèmes sont appliqués en général uniquement aux propriétés stylistiques ; l'attribut Themeable(false) doit être appliqué explicitement à toutes les propriétés non stylistiques. Décorer un membre avec l'attribut Themeable(false) garantit que le membre n'est pas à thème, indépendamment de la valeur de la propriété EnableTheming. Par exemple, si l'attribut ThemeableAttribute est appliqué à un contrôle et a la valeur false, le contrôle n'est pas affecté par les thèmes même quand sa propriété EnableTheming a la valeur true.

La classe ThemeableAttribute maintient une liste statique de tous les types qui prennent en charge des thèmes, et cette liste est consultée dès l'appel des méthodes statiques IsObjectThemeable et IsTypeThemeable.

L'exemple de code suivant montre comment appliquer l'attribut ThemeableAttribute au membre d'un contrôle. Dans cet exemple, ThemeableAttribute est appliqué à un contrôle lié aux données et false est passé au constructeur ThemeableAttribute, en indiquant qu'il est impossible d'appliquer des thèmes au membre DataSourceID. (Le passage de false au constructeur se traduit par une instance ThemeableAttribute qui est équivalente au champ No.)

namespace Samples.AspNet.CS.Controls {
    using System;
    using System.Web.UI;
    using System.Web.UI.WebControls;
    
    
    public class SomeDataBoundControl : DataBoundControl
    {
        // Implementation of a custom data source control.
        
        [Themeable(false) ]
        [IDReferenceProperty()]
        public override string DataSourceID {
            get {
                return base.DataSourceID;
            }
            set {
                base.DataSourceID = value;
            }
        }
        
    }
}

  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal

System.Object
   System.Attribute
    System.Web.UI.ThemeableAttribute

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0, 2.0
Afficher: