ContentPropertyAttribute Klasse

Definition

Namespace:

System.Windows.Markup

Assembly:

System.Xaml.dll

Zeigt an, welche Eigenschaft eines Typs die XAML-Inhaltseigenschaft ist. Ein XAML-Prozessor verwendet diese Informationen bei der Verarbeitung von untergeordneten XAML-Elementen von XAML-Darstellungen des attributierten Typs.

public ref class ContentPropertyAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)]
public sealed class ContentPropertyAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)>]
type ContentPropertyAttribute = class
    inherit Attribute

Public NotInheritable Class ContentPropertyAttribute
Inherits Attribute

Vererbung

Object

Attribute

ContentPropertyAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird eine Klasse mit dem Namen Film erstellt, die eine ContentPropertyAttribute angewendet hat. Die Eigenschaft namens Title wird als Inhaltseigenschaft angegeben.

[ContentProperty("Title")]
public class Film
{
    public Film()
    {
    }

    public string Title
    {
        get { return _title; }
        set { _title = value; }
    }

    private string _title;
}

<ContentProperty("Title")>
Public Class Film
    Public Sub New()
    End Sub

    Public Property Title() As String
        Get
            Return _title
        End Get
        Set(ByVal value As String)
            _title = value
        End Set
    End Property

    Private _title As String
End Class

Hinweise

Wenn die zugeordnete Eigenschaft eines ContentPropertyAttribute nicht vom Typ string oder objectist, versucht ein XAML-Prozessor, eine Wertkonvertierungsmethode zu identifizieren. Die erste Überprüfung ist die native Typkonvertierung, entweder der XAML-Sprachgrundtypen oder der spezifischen nativen Konvertierungen, die von dieser bestimmten XAML-Writer-Implementierung aktiviert werden. Der nächste Schritt besteht darin, nach einem Typkonverter zu suchen. In den .NET-Implementierungen wird ein Typkonverter basierend auf TypeConverterAttribute der Member- oder Typebenendefinition identifiziert, die gilt. Wenn keine Wertkonvertierung identifiziert werden kann, löst ein XAML-Objektschreiber in der Regel eine Ausnahme aus.

Um mehr als ein einzelnes Objektelement als Inhalt zu akzeptieren, muss der Typ der XAML-Inhaltseigenschaft als Sammlungstyp unterstützt werden können.

Aufgrund der Inherited=true Deklaration des Attributs wendet ein Wert für einen ContentPropertyAttribute normalerweise auch eine Inhaltseigenschaftsbezeichnung auf alle abgeleiteten Klassen an. Durch das Anwenden einer leeren ContentPropertyAttribute Klasse kann eine abgeleitete Klasse eine Deklaration eines Inhaltseigenschaftsattributs durch eine Basisklasse entfernen (und beachten, dass die Klasse keine Inhaltseigenschaft aufweist). Wenn Sie einen anderen Namen anwenden ContentPropertyAttribute , wird das geerbte ContentPropertyAttribute durch das neue ersetzt.

In früheren Versionen des .NET Framework war diese Klasse in der WPF-spezifischen Assembly WindowsBase vorhanden und verfügte auch über eine parallele Implementierung in Windows Communication Foundation (WCF). Ab dem .NET Framework 4.0 ContentPropertyAttribute befindet sich in der System.Xaml-Assembly. Weitere Informationen finden Sie unter Types Migrated from WPF to System.Xaml.

Hinweise zur WPF-Verwendung

Ein Beispiel für eine Klasse in Windows Presentation Foundation (WPF), die den ContentPropertyAttribute verwendet, ist ContentControl, von dem die Button Klasse erbt. Die ContentControl.Content -Eigenschaft ist die inhaltsbezogene Eigenschaft, die ContentPropertyAttributevon festgelegt wird. Wenn ein Button in XAML instanziiert wird, wird das Content von Button auf das Element festgelegt, das sich zwischen den Start- und End-Schaltflächentags befindet.

Konstruktoren

ContentPropertyAttribute()	Initialisiert eine neue Instanz der ContentPropertyAttribute-Klasse.
ContentPropertyAttribute(String)	Initialisiert eine neue Instanz der ContentPropertyAttribute-Klasse unter Verwendung des angegebenen Namens.

Eigenschaften

Name	Ruft den Namen der Eigenschaft ab, die die Inhaltseigenschaft ist.
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. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
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)

Weitere Informationen

• XAML-bezogene CLR-Attribute für benutzerdefinierte Typen und Bibliotheken
• Definieren benutzerdefinierter Typen für die Verwendung in .NET XAML-Diensten
• XAML-Dienste