ContentPropertyAttribute クラス

定義

名前空間:

System.Windows.Markup

アセンブリ:

System.Xaml.dll

型のどのプロパティが XAML コンテンツ プロパティであるかを示します。 この情報を使用して、XAML プロセッサは属性付き型の XAML 表現の XAML 子要素を処理します。

C#

[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=true)]
public sealed class ContentPropertyAttribute : Attribute

継承

Object

Attribute

ContentPropertyAttribute

属性

AttributeUsageAttribute

例

次の例では、 が適用されている という名前 Film のクラスを ContentPropertyAttribute 作成します。 という名前 Title のプロパティは、content プロパティとして示されます。

C#

[ContentProperty("Title")]
public class Film
{
    public Film()
    {
    }

    public string Title
    {
        get { return _title; }
        set { _title = value; }
    }

    private string _title;
}

注釈

の関連付けられたプロパティ ContentPropertyAttribute が 型 string または objectでない場合、XAML プロセッサは値変換手法の識別を試みます。 最初のチェックは、XAML 言語プリミティブのいずれか、またはその特定の XAML ライター実装によって有効になっている特定のネイティブ変換のネイティブ型変換用です。 次の手順では、型コンバーターを探します。 .NET 実装では、型コンバーターは、適用されるメンバー レベルまたは型レベル定義に基づいて TypeConverterAttribute 識別されます。 値変換を識別できない場合、XAML オブジェクト ライターは通常、例外をスローします。

1 つ以上のオブジェクト要素をコンテンツとして受け入れるためには、XAML コンテンツ プロパティの型をコレクション型としてサポートできる必要があります。

属性の Inherited=true 宣言により、 の値 ContentPropertyAttribute は通常、すべての派生クラスにもコンテンツ プロパティの指定を適用します。 空 ContentPropertyAttribute を適用すると、派生クラスは基底クラスによってコンテンツ プロパティ属性の宣言を削除できます (また、クラスにコンテンツ プロパティがないことに注意してください)。 別の名前 ContentPropertyAttribute を適用すると、継承された ContentPropertyAttribute が新しい名前に置き換えられます。

以前のバージョンの.NET Frameworkでは、このクラスは WPF 固有のアセンブリ WindowsBase に存在し、Windows Communication Foundation (WCF) にも並列実装されていました。 .NET Framework 4.0 以降では、 ContentPropertyAttribute は System.Xaml アセンブリにあります。 詳細については、「 Types Migrated from WPF to System.Xaml」を参照してください。

WPF の使用上の注意

を使用ContentPropertyAttributeする Windows Presentation Foundation (WPF) のクラスの例は、 ContentControlクラスがButton継承する です。 プロパティは ContentControl.Content 、 によって設定される ContentPropertyAttributeコンテンツ プロパティです。 Buttonが XAML でインスタンス化されている場合、 Content の Button は開始ボタンタグと終了ボタン タグの間にある要素に設定されます。

コンストラクター

ContentPropertyAttribute()	ContentPropertyAttribute クラスの新しいインスタンスを初期化します。
ContentPropertyAttribute(String)	指定された名前を使用して、ContentPropertyAttribute クラスの新しいインスタンスを初期化します。

プロパティ

Name	コンテンツ プロパティであるプロパティの名前を取得します。

適用対象

こちらもご覧ください

• カスタム型とライブラリの XAML 関連の CLR 属性
• .NET XAML サービスで使用するカスタム型を定義する
• XAML サービス