ContentPropertyAttribute Klass

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

Arv

Object

Attribute

ContentPropertyAttribute

Attribut

AttributeUsageAttribute

Exempel

I följande exempel skapas en klass med namnet Film som har tillämpats ContentPropertyAttribute . Egenskapen med namnet Title anges som innehållsegenskap.

[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

Kommentarer

Om den associerade egenskapen för en ContentPropertyAttribute inte är av typen string eller objectförsöker en XAML-processor identifiera en värdekonverteringsteknik. Den första kontrollen gäller konvertering av ursprunglig typ, antingen av XAML-språkprimitiver eller specifika interna konverteringar som aktiveras av den specifika XAML-skrivarimplementeringen. Nästa steg är att leta efter en typkonverterare. I de .NET implementeringarna identifieras en typkonverterare baserat på TypeConverterAttribute på antingen den medlemsnivå eller typnivådefinition som gäller. Om ingen värdekonvertering kan identifieras utlöser en XAML-objektskrivare vanligtvis ett undantag.

För att kunna acceptera mer än ett objektelement som innehåll måste typen av XAML-innehållsegenskap vara stödbar som en samlingstyp.

På grund av deklarationen Inherited=true av attributet tillämpar ett värde för en ContentPropertyAttribute normalt en egenskapsbeteckning för innehåll även för alla härledda klasser. Om du tillämpar ett tomt ContentPropertyAttribute värde kan en härledd klass ta bort en deklaration av ett innehållsegenskapsattribut av en basklass (och observera att klassen inte har någon innehållsegenskap). Om du använder ett annat namn ContentPropertyAttribute ersätts ärvda ContentPropertyAttribute med den nya.

I tidigare versioner av .NET Framework fanns den här klassen i den WPF specifika sammansättningen WindowsBase och hade även en parallell implementering i Windows Communication Foundation (WCF). Från och med .NET Framework 4.0 finns ContentPropertyAttribute i System.Xaml-sammansättningen. Mer information finns i Types Migrerad från WPF till System.Xaml.

WPF-användningsanteckningar

Ett exempel på en klass i Windows Presentation Foundation (WPF) som använder ContentPropertyAttribute är ContentControl, som klassen Button ärver från. Egenskapen ContentControl.Content är den innehållsegenskap som anges av ContentPropertyAttribute. Om en Button instansieras i XAML Content , anges för Button -elementet som är mellan start- och slutknapptaggar.

Se även

• XAML-relaterade CLR-attribut för anpassade typer och bibliotek
• Define anpassade typer för användning med .NET XAML-tjänster
• XAML-tjänster