ContentPropertyAttribute Klas

Definitie

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

Overname

Object

Attribute

ContentPropertyAttribute

Kenmerken

AttributeUsageAttribute

Voorbeelden

In het volgende voorbeeld wordt een klasse gemaakt die Film een ContentPropertyAttribute toegepaste klasse heeft. De benoemde Title eigenschap wordt aangegeven als de inhoudseigenschap.

[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

Opmerkingen

Als de bijbehorende eigenschap van een ContentPropertyAttribute niet van het type string is of object, probeert een XAML-processor een methode voor waardeconversie te identificeren. De eerste controle is voor systeemeigen typeconversie, ofwel van de XAML-taalprimitieven of van specifieke systeemeigen conversies die zijn ingeschakeld door die specifieke XAML writer-implementatie. De volgende stap is het zoeken naar een typeconversieprogramma. In de .NET implementaties wordt een typeconversieprogramma geïdentificeerd op basis van TypeConverterAttribute op het niveau van het lid of typeniveau dat van toepassing is. Als er geen waardeconversie kan worden geïdentificeerd, genereert een XAML-objectschrijver doorgaans een uitzondering.

Als u meer dan één objectelement als inhoud wilt accepteren, moet het type XAML-inhoudseigenschap worden ondersteund als een verzamelingstype.

Vanwege de Inherited=true declaratie van het kenmerk wordt ook een waarde voor een ContentPropertyAttribute inhoudseigenschap toegepast op alle afgeleide klassen. Als u een lege ContentPropertyAttribute toepassing toepast, kan een afgeleide klasse een declaratie van een inhoudseigenschapskenmerk door een basisklasse verwijderen (en om te weten dat de klasse geen inhoudseigenschap heeft). Als u een andere naam ContentPropertyAttribute toepast, wordt de overgenomen ContentPropertyAttribute door de nieuwe vervangen.

In eerdere versies van het .NET Framework bestond deze klasse in de WPF-specifieke assembly WindowsBase en had deze ook een parallelle implementatie in Windows Communication Foundation (WCF). Vanaf het .NET Framework 4.0 bevindt ContentPropertyAttribute zich in de System.Xaml-assembly. Zie Types gemigreerd van WPF naar System.Xaml voor meer informatie.

Opmerkingen bij WPF-gebruik

Een voorbeeld van een klasse in Windows Presentation Foundation (WPF) die gebruikmaakt van de ContentPropertyAttribute is ContentControl, waarvan de klasse Button overgaat. De ContentControl.Content eigenschap is de inhoudseigenschap die is ingesteld door de ContentPropertyAttribute. Als een Button instantie wordt geïnstantieerd in XAML, wordt de Content waarde Button ingesteld op het element tussen de tags voor de start- en eindknop.

Zie ook

• XAML-gerelateerde CLR-kenmerken voor aangepaste typen en bibliotheken
• Definieerde aangepaste typen voor gebruik met .NET XAML Services
• XAML-services