ContentPropertyAttribute Klasse

Definition

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

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für:

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