ThemeableAttribute Класс

Определение

Определяет атрибут метаданных, который используется серверными веб-элементами управления и их членами, чтобы указать, могут ли на их отрисовку повлиять темы и обложки элементов управления.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. Этот класс не наследуется.This class cannot be inherited.

public ref class ThemeableAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Property)]
public sealed class ThemeableAttribute : Attribute
type ThemeableAttribute = class
    inherit Attribute
Public NotInheritable Class ThemeableAttribute
Inherits Attribute
Наследование
ThemeableAttribute
Атрибуты

Примеры

В следующем примере кода показано, как можно применить ThemeableAttribute атрибут к члену элемента управления.The following code example demonstrates how you can apply the ThemeableAttribute attribute to a member of a control. В ThemeableAttribute этом примере применяется к элементу управления с привязкой к данным false и передается ThemeableAttribute в конструктор, указывая, DataSourceID что к элементу не могут применяться темы.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. (Передача false в конструктор приводит ThemeableAttribute к поопределению экземпляра No , эквивалентного полю.)(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

Комментарии

Разработчики элементов управления используют ThemeableAttribute атрибут для оформления типов элементов управления и их членов, чтобы сообщить, какие из них могут и не могут быть затронуты темами и обложками элементов управления.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. По умолчанию все свойства, предоставляемые элементом управления, являются темами.By default, all properties exposed by a control are themeable. Однако темы обычно применяются только к свойствам стилистических свойств. Themeable(false) атрибут должен применяться явно ко всем свойствам, не являющимся стилистическими.However, themes are typically applied only to stylistic properties; the Themeable(false) attribute should be applied explicitly to all non-stylistic properties. При Themeable(false) оформлении элемента атрибутом гарантируется, что элемент не будет включен в тему независимо от значения EnableTheming свойства.Decorating a member with the Themeable(false) attribute ensures that the member is not themed, regardless of the value of the EnableTheming property. Например, если ThemeableAttribute атрибут применяется к элементу управления и имеет falseзначение, темы этого элемента управления не затрагиваются, даже если trueего EnableTheming свойство имеет значение.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.

Класс поддерживает статический список всех типов, поддерживающих темы, и к этому списку обращаются при каждом вызове статических IsTypeThemeable методов IsObjectThemeable. ThemeableAttributeThe 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.

Конструкторы

ThemeableAttribute(Boolean)

Выполняет инициализацию нового экземпляра класса ThemeableAttribute с использованием заданного логического значения, для определения, представляет ли атрибут тип или член, к которым применяются темы и обложки элементов управления.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.

Поля

Default

Возвращает экземпляр ThemeableAttribute, который представляет определенное приложением значение атрибута по умолчанию.Gets a ThemeableAttribute instance that represents the application-defined default value of the attribute.

No

Возвращает экземпляр ThemeableAttribute, используемый для оформления типа или члена, к которым не применяются темы и обложки элементов управления.Gets a ThemeableAttribute instance used to decorate a type or member that is not affected by themes and control skins.

Yes

Возвращает экземпляр ThemeableAttribute, используемый для оформления типа или члена, к которым применяются темы и обложки элементов управления.Gets a ThemeableAttribute instance used to decorate a type or member that is affected by themes and control skins.

Свойства

Themeable

Возвращает значение, указывающее, применяются ли к текущему элементу управления или члену элемента управления темы и обложки элементов управления, определенные для веб-приложения.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

При реализации в производном классе возвращает уникальный идентификатор для этого Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Унаследовано от Attribute)

Методы

Equals(Object)

Возвращает значение, показывающее, равен ли экземпляр указанному объекту.Returns a value that indicates whether this instance is equal to a specified object.

GetHashCode()

Служит в качестве хэш-функции для типа ThemeableAttribute.Serves as a hash function for the ThemeableAttribute type.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
IsDefaultAttribute()

Возвращает значение, указывающее, эквивалентен ли текущий экземпляр экземпляру Default класса ThemeableAttribute.Gets a value indicating whether the current instance is equivalent to a Default instance of the ThemeableAttribute class.

IsObjectThemeable(Object)

Возвращает значение, указывающее, передается ли объект в метод, поддерживающий темы.Returns a value indicating whether the object passed to the method supports themes.

IsTypeThemeable(Type)

Возвращает значение, указывающее, передается ли тип Type в метод, поддерживающий темы.Returns a value indicating whether the Type passed to the method supports themes.

Match(Object)

При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Унаследовано от Attribute)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Явные реализации интерфейса

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.Maps a set of names to a corresponding set of dispatch identifiers.

(Унаследовано от Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Унаследовано от Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Унаследовано от Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.Provides access to properties and methods exposed by an object.

(Унаследовано от Attribute)

Применяется к

Дополнительно