ThemeableAttribute Classe

Définition

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.Defines the metadata attribute that Web server controls and their members use to indicate whether their rendering can be affected by themes and control skins. Cette classe ne peut pas être héritée.This class cannot be inherited.

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
ThemeableAttribute
Attributs

Exemples

L’exemple de code suivant montre comment vous pouvez appliquer l' ThemeableAttribute attribut à un membre d’un contrôle.The following code example demonstrates how you can apply the ThemeableAttribute attribute to a member of a control. 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.In this example, ThemeableAttribute is applied to a data-bound control and false is passed to the ThemeableAttribute constructor, indicating that the DataSourceID member cannot have themes applied. (Passer false au constructeur entraîne une ThemeableAttribute instance qui est équivalente au No champ.)(Passing false to the constructor results in a ThemeableAttribute instance that is equivalent to the No field.)

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' ThemeableAttribute attribut pour décorer les types de contrôle 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.Control developers use the ThemeableAttribute attribute to decorate control types and their members, to signal which ones can and cannot be affected by themes and control skins. Par défaut, toutes les propriétés exposées par un contrôle sont associées à un thème.By default, all properties exposed by a control are themeable. Toutefois, les thèmes sont généralement appliqués uniquement aux propriétés stylistiques ; l' Themeable(false) attribut doit être appliqué explicitement à toutes les propriétés non stylistiques.However, themes are typically applied only to stylistic properties; the Themeable(false) attribute should be applied explicitly to all non-stylistic properties. La décoration d’un membre avec l' Themeable(false) attribut garantit que le membre n’est pas à thème, quelle que soit la valeur de la EnableTheming propriété.Decorating a member with the Themeable(false) attribute ensures that the member is not themed, regardless of the value of the EnableTheming property. Par exemple, si l' ThemeableAttribute attribut est appliqué à un contrôle et a false la valeur, le contrôle n’est pas affecté par les thèmes même lorsque sa EnableTheming propriété a la valeur true .For example, if the ThemeableAttribute attribute is applied to a control and set to false, the control is not affected by themes even when its EnableTheming property is set to true.

La ThemeableAttribute classe gère 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 statiques IsObjectThemeable et IsTypeThemeable sont appelées.The ThemeableAttribute class maintains a static list of all types that support themes, and this list is consulted whenever the static methods IsObjectThemeable and IsTypeThemeable are called.

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.Initializes a new instance of the ThemeableAttribute class, using the specified Boolean value to determine whether the attribute represents a type or member that is affected by themes and control skins.

Champs

Default

Obtient une instance ThemeableAttribute qui représente la valeur par défaut définie par l'application de l'attribut.Gets a ThemeableAttribute instance that represents the application-defined default value of the attribute.

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.Gets a ThemeableAttribute instance used to decorate a type or member that is not affected by themes and control skins.

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.Gets a ThemeableAttribute instance used to decorate a type or member that is affected by themes and control skins.

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.Gets a value indicating whether the current control or member of a control can be affected by themes and control skins defined for the Web application.

TypeId

Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Hérité de Attribute)

Méthodes

Equals(Object)

Retourne une valeur qui indique si cette instance est égale à un objet spécifié.Returns a value that indicates whether this instance is equal to a specified object.

GetHashCode()

Sert de fonction de hachage pour le type ThemeableAttribute.Serves as a hash function for the ThemeableAttribute type.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
IsDefaultAttribute()

Obtient une valeur qui indique si l'instance en cours est équivalente à une instance Default de la classe ThemeableAttribute.Gets a value indicating whether the current instance is equivalent to a Default instance of the ThemeableAttribute class.

IsObjectThemeable(Object)

Retourne une valeur indiquant si l'objet passé à la méthode prend en charge des thèmes.Returns a value indicating whether the object passed to the method supports themes.

IsTypeThemeable(Type)

Retourne une valeur indiquant si le Type passé à la méthode prend en charge des thèmes.Returns a value indicating whether the Type passed to the method supports themes.

Match(Object)

En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Hérité de Attribute)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(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.Maps a set of names to a corresponding set of dispatch identifiers.

(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.Retrieves the type information for an object, which can be used to get the type information for an 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).Retrieves the number of type information interfaces that an object provides (either 0 or 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.Provides access to properties and methods exposed by an object.

(Hérité de Attribute)

S’applique à

Voir aussi