ContentPropertyAttribute Třída

Definice

Obor názvů:

System.Windows.Markup

Sestavení:

System.Xaml.dll

Určuje, která vlastnost typu je vlastnost obsahu XAML. Procesor XAML používá tyto informace při zpracování podřízených elementů XAML reprezentací jazyka XAML atributu.

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

Dědičnost

Object

Attribute

ContentPropertyAttribute

Atributy

AttributeUsageAttribute

Příklady

Následující příklad vytvoří třídu s názvem Film , která má použitou ContentPropertyAttribute . Vlastnost s názvem Title je označena jako vlastnost obsahu.

[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

Poznámky

Pokud přidružená vlastnost ContentPropertyAttribute typu nebo stringobject, procesor XAML se pokusí identifikovat metodu převodu hodnoty. První kontrola spočívá v převodu nativního typu, ať už z primitiv jazyka XAML nebo konkrétních nativních převodů povolených konkrétní implementací zapisovače XAML. Dalším krokem je vyhledání převaděče typů. V implementacích .NET je převaděč typů identifikován na TypeConverterAttribute základě buď členské úrovně, nebo definice úrovně typu, která se vztahuje. Pokud nelze identifikovat žádný převod hodnoty, zapisovač objektu XAML obvykle vyvolá výjimku.

Aby bylo možné přijmout více než jeden prvek objektu jako obsah, musí být typ vlastnosti obsahu XAML podporován jako typ kolekce.

Inherited=true Vzhledem k deklaraci atributu, hodnota pro ContentPropertyAttribute normální použití označení vlastnosti obsahu také pro všechny odvozené třídy. Použití prázdné ContentPropertyAttribute umožňuje odvozené třídě odebrat deklaraci atributu vlastnosti obsahu základní třídou (a uvědomit si, že třída nemá žádnou vlastnost obsahu). Použití jiného pojmenovaného ContentPropertyAttribute nahradí zděděný ContentPropertyAttribute novým názvem.

V předchozích verzích rozhraní .NET Framework existovala tato třída v sestavení wpF specifickém pro WindowsBase a měla také paralelní implementaci ve Windows Communication Foundation (WCF). Počínaje rozhraním .NET Framework 4.0 ContentPropertyAttribute je v sestavení System.Xaml. Další informace naleznete v tématu Typy migrované z WPF do System.Xaml.

Poznámky k využití WPF

Příklad třídy ve Windows Presentation Foundation (WPF), který používá ContentPropertyAttribute je ContentControl, který Button třída dědí z. Vlastnost ContentControl.Content je vlastnost obsahu nastavena .ContentPropertyAttribute Button Pokud je instance v XAML, Content bude nastavena Button na element, který je mezi značkami počátečního a koncového tlačítka.

Konstruktory

Name	Description
ContentPropertyAttribute()	Inicializuje novou instanci ContentPropertyAttribute třídy.
ContentPropertyAttribute(String)	Inicializuje novou instanci ContentPropertyAttribute třídy pomocí zadaného názvu.

Vlastnosti

Name	Description
Name	Získá název vlastnosti, která je vlastnost obsahu.

Viz také

• Atributy CLR související s XAML pro vlastní typy a knihovny
• Definování vlastních typů pro použití se službami .NET XAML Services
• Služby XAML