ThemeableAttribute Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit l’attribut de métadonnées que le serveur Web contrôle et ses membres utilisent pour indiquer si leur rendu peut être affecté par les thèmes et les 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
- Attributs
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 transmis au ThemeableAttribute constructeur, ce qui indique que le DataSourceID membre ne peut pas avoir de thèmes appliqués. (Le passage false au constructeur entraîne 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, pour 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èmeables. 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 à thème, quelle que soit la valeur de la EnableTheming propriété. Par exemple, si l’attribut ThemeableAttribute est appliqué à un contrôle et falsedéfini sur , le contrôle n’est pas affecté par les thèmes même quand sa EnableTheming propriété est définie sur 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 IsObjectThemeable statiques et IsTypeThemeable sont appelées.
Constructeurs
| Nom | Description |
|---|---|
| ThemeableAttribute(Boolean) |
Initialise une nouvelle instance de la ThemeableAttribute classe à l’aide de la valeur booléenne spécifiée pour déterminer si l’attribut représente un type ou un membre affecté par les thèmes et les apparences de contrôle. |
Champs
| Nom | Description |
|---|---|
| Default |
Obtient une ThemeableAttribute instance qui représente la valeur par défaut définie par l’application de l’attribut. |
| No |
Obtient une ThemeableAttribute instance utilisée pour décorer un type ou un membre qui n’est pas affecté par les thèmes et les apparences de contrôle. |
| Yes |
Obtient une ThemeableAttribute instance utilisée pour décorer un type ou un membre affecté par les thèmes et les apparences de contrôle. |
Propriétés
| Nom | Description |
|---|---|
| Themeable |
Obtient une valeur indiquant si le contrôle actuel ou le membre d’un contrôle peut être affecté par les thèmes et les apparences de contrôle définies pour l’application web. |
| TypeId |
En cas d’implémentation dans une classe dérivée, obtient un identificateur unique pour cette Attribute. (Hérité de Attribute) |
Méthodes
| Nom | Description |
|---|---|
| Equals(Object) |
Retourne une valeur qui indique si cette instance est égale à un objet spécifié. |
| GetHashCode() |
Sert de fonction de hachage pour le ThemeableAttribute type. |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| IsDefaultAttribute() |
Obtient une valeur indiquant si l’instance actuelle est équivalente à une Default instance de la ThemeableAttribute classe. |
| IsObjectThemeable(Object) |
Retourne une valeur indiquant si l’objet passé à la méthode prend en charge les thèmes. |
| IsTypeThemeable(Type) |
Retourne une valeur indiquant si le Type passé à la méthode prend en charge les thèmes. |
| Match(Object) |
En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| _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 d’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 méthodes exposées par un objet. (Hérité de Attribute) |