ContentPropertyAttribute Sınıf

Tanım

Ad Alanı:

System.Windows.Markup

Bütünleştirilmiş Kod:

System.Xaml.dll

Bir türün hangi özelliğinin XAML içerik özelliği olduğunu gösterir. XAML işlemcisi, öznitelikli türün XAML gösterimlerinin XAML alt öğelerini işlerken bu bilgileri kullanır.

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

Devralma

Object

Attribute

ContentPropertyAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

Aşağıdaki örnek, uygulanmış adlı Film bir ContentPropertyAttribute sınıf oluşturur. adlı Title özellik, içerik özelliği olarak belirtilir.

[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

Açıklamalar

bir ContentPropertyAttribute öğesinin ilişkili özelliği veya objecttüründe string değilse, XAML işlemcisi bir değer dönüştürme tekniğini belirlemeye çalışır. İlk denetim, XAML dil temel öğelerinden biri veya söz konusu XAML yazıcı uygulaması tarafından etkinleştirilen belirli yerel dönüştürmeler olan yerel tür dönüştürme içindir. Sonraki adım bir tür dönüştürücüsü aramaktır. .NET uygulamalarında, bir tür dönüştürücüsü, uygulanan üye düzeyine veya tür düzeyi tanımına göre TypeConverterAttribute tanımlanır. Değer dönüştürme tanımlanamazsa, XAML nesne yazıcısı genellikle bir özel durum oluşturur.

tek bir nesne öğesinden fazlasını içerik olarak kabul etmek için, XAML içerik özelliğinin türü koleksiyon türü olarak desteklenebilir olmalıdır.

Inherited=true özniteliğinin bildirimi nedeniyle, değeri ContentPropertyAttribute normalde türetilmiş tüm sınıflara da içerik özelliği ataması uygular. Boş ContentPropertyAttribute bir uygulama, türetilmiş bir sınıfın bir temel sınıf tarafından content özelliği özniteliği bildirimini kaldırmasını sağlar (ve sınıfın içerik özelliği olmadığını unutmayın). Farklı bir adlandırılmış ContentPropertyAttribute uygulama, devralınan ContentPropertyAttribute öğesini yenisiyle değiştirir.

.NET Framework'ün önceki sürümlerinde, bu sınıf WPF'ye özgü WindowsBase derlemesinde vardı ve ayrıca Windows Communication Foundation'da (WCF) paralel bir uygulamaya sahipti. .NET Framework 4.0 ile başlayarak System.Xaml ContentPropertyAttribute derlemesindedir. Daha fazla bilgi için bkz . WPF'den System.Xaml'e Geçirilen Türler.

WPF Kullanım Notları

Windows Presentation Foundation'da (WPF) öğesini kullanan ContentPropertyAttribute bir sınıf örneği, sınıfın devraldığı Button öğesidirContentControl. ContentControl.Content özelliği, tarafından ContentPropertyAttributeayarlanan içerik özelliğidir. XAML'de örneği Button oluşturulursa, Content öğesinin Button örneği başlangıç ve bitiş düğmesi etiketleri arasındaki öğeye ayarlanır.

Oluşturucular

Name	Description
ContentPropertyAttribute()	ContentPropertyAttribute sınıfının yeni bir örneğini başlatır.
ContentPropertyAttribute(String)	Belirtilen adı kullanarak sınıfının yeni bir örneğini ContentPropertyAttribute başlatır.

Özellikler

Name	Description
Name	İçerik özelliği olan özelliğin adını alır.

Ayrıca bkz.

• Özel türler ve kitaplıklar için XAML ile ilgili CLR öznitelikleri
• .NET XAML Hizmetleri ile kullanılmak üzere özel türler tanımlama
• XAML Hizmetleri