ThemeableAttribute Classe

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

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.

public ref class ThemeableAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Property)]
public sealed class ThemeableAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Property)>]
type ThemeableAttribute = class
    inherit Attribute

Public NotInheritable Class ThemeableAttribute
Inherits Attribute

Héritage

Object

Attribute

ThemeableAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple de code suivant montre comment appliquer l’attribut ThemeableAttribute à un membre d’un contrôle. Dans cet exemple, ThemeableAttribute est appliqué à un contrôle lié aux données et false est passé au ThemeableAttribute constructeur, ce qui indique que le DataSourceID membre ne peut pas avoir de thèmes appliqués. (Le passage false au constructeur aboutit à une ThemeableAttribute instance équivalente au No champ.)

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;
            }
        }
    }
}

Imports System.Web.UI
Imports System.Web.UI.WebControls

Public Class SomeDataBoundControl
    Inherits DataBoundControl

    ' Implementation of a custom data source control.
    
    <Themeable(False)> _
    <IDReferenceProperty()>  _
    Public Overrides Property DataSourceID() As String 
        Get
            Return MyBase.DataSourceID
        End Get
        Set
            MyBase.DataSourceID = value
        End Set
    End Property
    
End Class

Remarques

Les développeurs de contrôles utilisent l’attribut ThemeableAttribute pour décorer les types de contrôles et leurs membres, afin de signaler ceux qui peuvent et ne peuvent pas être affectés par les thèmes et les apparences de contrôle. Par défaut, toutes les propriétés exposées par un contrôle sont à thème. Toutefois, les thèmes sont généralement appliqués uniquement aux propriétés stylistiques ; l’attribut Themeable(false) doit être appliqué explicitement à toutes les propriétés non stylistiques. La décoration d’un membre avec l’attribut Themeable(false) garantit que le membre n’est pas un thème, quelle que soit la valeur de la EnableTheming propriété. Par exemple, si l’attribut ThemeableAttribute est appliqué à un contrôle et défini sur false, le contrôle n’est pas affecté par les thèmes même lorsque sa EnableTheming propriété est définie sur true.

La ThemeableAttribute classe conserve une liste statique de tous les types qui prennent en charge les thèmes, et cette liste est consultée chaque fois que les méthodes IsObjectThemeable statiques et IsTypeThemeable sont appelées.

Constructeurs

ThemeableAttribute(Boolean)

Initialise une nouvelle instance de la classe ThemeableAttribute, à l'aide de la valeur booléenne spécifiée pour déterminer si l'attribut représente ou non un type ou un membre affecté par des thèmes et des apparences de contrôle.

Champs

Default	Obtient une instance ThemeableAttribute qui représente la valeur par défaut définie par l'application de l'attribut.
No	Obtient une instance ThemeableAttribute utilisée pour décorer un type ou un membre qui n'est pas affecté par des thèmes ni des apparences de contrôle.
Yes	Obtient une instance ThemeableAttribute utilisée pour décorer un type ou un membre affecté par des thèmes et des apparences de contrôle.

Propriétés

Themeable	Obtient une valeur indiquant si le contrôle ou le membre actuel d'un contrôle peut être affecté par des thèmes et des apparences de contrôle définis pour l'application Web.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

Méthodes

Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié.
GetHashCode()	Sert de fonction de hachage pour le type ThemeableAttribute.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	Obtient une valeur qui indique si l'instance en cours est équivalente à une instance Default de la classe ThemeableAttribute.
IsObjectThemeable(Object)	Retourne une valeur indiquant si l'objet passé à la méthode prend en charge des thèmes.
IsTypeThemeable(Type)	Retourne une valeur indiquant si le Type passé à la méthode prend en charge des thèmes.
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface. (Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fournit l'accès aux propriétés et aux méthodes exposées par un objet. (Hérité de Attribute)

Voir aussi

• vue d’ensemble des thèmes et des apparences ASP.NET