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. Bir 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 tanımlamaya çalışır. İlk denetim, XAML dil temel öğelerinden veya söz konusu XAML yazıcı uygulaması tarafından etkinleştirilen belirli yerel dönüştürmelerden oluşan 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, uygulanan üye düzeyine veya tür düzeyi tanımına göre TypeConverterAttribute bir tür dönüştürücü tanımlanır. Değer dönüştürme tanımlanamazsa, XAML nesne yazıcısı genellikle bir özel durum oluşturur.

İçerik olarak tek bir nesne öğesinden fazlasını 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 bir içerik ö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 ö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 (WPF) içinde öğesini kullanan ContentPropertyAttribute bir sınıf örneği, sınıfını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

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	İçerik özelliği olan özelliğin adını alır.
TypeId	Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır. (Devralındığı yer: Attribute)

Yöntemler

Equals(Object)	Bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değeri döndürür. (Devralındığı yer: Attribute)
GetHashCode()	Bu örneğe ilişkin karma kodu döndürür. (Devralındığı yer: Attribute)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IsDefaultAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir. (Devralındığı yer: Attribute)
Match(Object)	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

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