ThemeableAttribute Klasse

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Definiert das Metadatenattribut, mit dem Webserversteuerelemente und die zugehörigen Member angeben, ob ihre Darstellung durch Designs und Steuerelementskins beeinflusst werden kann. Diese Klasse kann nicht vererbt werden.

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

Vererbung: Object

Attribute
ThemeableAttribute

Attribute: AttributeUsageAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie das ThemeableAttribute Attribut auf ein Element eines Steuerelements anwenden können. In diesem Beispiel ThemeableAttribute wird auf ein datengebundenes Steuerelement angewendet und false an den ThemeableAttribute Konstruktor übergeben, was angibt, dass für den DataSourceID Member keine Designs angewendet werden können. (Das Übergeben false an den Konstruktor führt zu einer ThemeableAttribute Instanz, die dem No Feld entspricht.)

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

Hinweise

Steuerelemententwickler verwenden das ThemeableAttribute -Attribut, um Steuerelementtypen und deren Member zu dekorieren, um zu signalisieren, welche von Designs und Steuerelementskins beeinflusst werden können und welche nicht. Standardmäßig sind alle Eigenschaften, die von einem Steuerelement verfügbar gemacht werden, designierbar. Designs werden jedoch in der Regel nur auf stilistische Eigenschaften angewendet. Das Themeable(false) Attribut sollte explizit auf alle nicht stilistischen Eigenschaften angewendet werden. Durch das Dekorieren eines Elements mit dem Themeable(false) -Attribut wird sichergestellt, dass das Element unabhängig vom Wert der Eigenschaft nicht themenunabhängig EnableTheming ist. Wenn das ThemeableAttribute Attribut beispielsweise auf ein Steuerelement angewendet und auf falsefestgelegt wird, wird das Steuerelement nicht von Designs beeinflusst, auch wenn seine EnableTheming Eigenschaft auf truefestgelegt ist.

Die ThemeableAttribute -Klasse verwaltet eine statische Liste aller Typen, die Designs unterstützen, und diese Liste wird bei jedem Aufruf der statischen Methoden IsObjectThemeable und IsTypeThemeable aufgerufen.

Konstruktoren

ThemeableAttribute(Boolean)

Initialisiert eine neue Instanz der ThemeableAttribute-Klasse. Dabei wird anhand des angegebenen booleschen Werts bestimmt, ob das Attribut einen Typ oder Member darstellt, der von Designs und Steuerelementskins beeinflusst wird.

Felder

Default	Ruft eine ThemeableAttribute-Instanz ab, die den anwendungsdefinierten Standardwert des Attributs darstellt.
No	Ruft eine ThemeableAttribute-Instanz zum Ergänzen eines Typs oder Members ab, der nicht von Designs und Steuerelementskins beeinflusst wird.
Yes	Ruft eine ThemeableAttribute-Instanz zum Ergänzen eines Typs oder Members ab, der von Designs und Steuerelementskins beeinflusst wird.

Eigenschaften

Themeable	Ruft einen Wert ab, der angibt, ob das aktuelle Steuerelement oder der aktuelle Member eines Steuerelements von Designs und Steuerelementskins beeinflusst werden kann, die für die Webanwendung festgelegt wurden.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.
GetHashCode()	Fungiert als Hashfunktion für den ThemeableAttribute-Typ.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Ruft einen Wert ab, der angibt, dass die aktuelle Instanz gleich einer Default-Instanz der ThemeableAttribute-Klasse ist.
IsObjectThemeable(Object)	Gibt einen Wert zurück, der angibt, ob das an die Methode übergebene Objekt Designs unterstützt.
IsTypeThemeable(Type)	Gibt einen Wert zurück, der angibt, ob der an die Methode übergebene Type Designs unterstützt.
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Geerbt von Attribute)

Gilt für:

Weitere Informationen

Übersicht über ASP.NET Designs und Skins

Freigeben über