ContentPropertyAttribute Classe

Definizione

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

Ereditarietà

Object

Attribute

ContentPropertyAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio seguente viene creata una classe denominata Film a cui è applicato un oggetto ContentPropertyAttribute . La proprietà denominata Title è indicata come proprietà content.

[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

Commenti

Se la proprietà associata di un ContentPropertyAttribute oggetto non è di tipo string o object, un processore XAML tenta di identificare una tecnica di conversione di valori. Il primo controllo riguarda la conversione del tipo nativo, le primitive del linguaggio XAML o le conversioni native specifiche abilitate da tale particolare implementazione del writer XAML. Il passaggio successivo consiste nel cercare un convertitore di tipi. Nelle implementazioni di .NET viene identificato un convertitore di tipi basato sulla TypeConverterAttribute definizione del livello membro o del livello di tipo applicabile. Se non è possibile identificare alcuna conversione di valori, un writer di oggetti XAML genera in genere un'eccezione.

Per accettare più di un singolo elemento oggetto come contenuto, il tipo della proprietà del contenuto XAML deve essere supportabile come tipo di raccolta.

A causa della Inherited=true dichiarazione dell'attributo, anche un valore per un ContentPropertyAttribute oggetto applica una designazione di proprietà contenuto a tutte le classi derivate. L'applicazione di un oggetto vuoto ContentPropertyAttribute consente a una classe derivata di rimuovere una dichiarazione di un attributo di proprietà del contenuto da una classe base (e per notare che la classe non ha alcuna proprietà di contenuto). L'applicazione di un nome ContentPropertyAttribute diverso sostituisce l'oggetto ereditato ContentPropertyAttribute con quello nuovo.

Nelle versioni precedenti di .NET Framework, questa classe esisteva nell'assembly specifico di WPF WindowsBase e aveva anche un'implementazione parallela in Windows Communication Foundation (WCF). A partire da .NET Framework 4.0, ContentPropertyAttribute si trova nell'assembly System.Xaml. Per altre informazioni, vedere Types Migrated from WPF to System.Xaml.

Note sull'utilizzo di WPF

Esempio di classe in Windows Presentation Foundation (WPF) che usa ContentPropertyAttribute è ContentControl, da cui eredita la Button classe . La ContentControl.Content proprietà è la proprietà content impostata da ContentPropertyAttribute. Se viene Button creata un'istanza in XAML, l'oggetto ButtonContent di verrà impostato sull'elemento compreso tra i tag del pulsante iniziale e finale.

Costruttori

Proprietà

Metodi

Implementazioni dell'interfaccia esplicita

Si applica a

Vedi anche

• Attributi CLR correlati a XAML per tipi e librerie personalizzati
• Definire tipi personalizzati da usare con i servizi XAML .NET
• Servizi XAML