ConstructorArgumentAttribute クラス

定義

名前空間:

System.Windows.Markup

アセンブリ:

System.Xaml.dll

パラメーターなし以外のコンストラクター構文を使用してオブジェクトを初期化できることと、指定した名前のプロパティが構造情報を提供できることを指定します。 この情報は主に XAML シリアル化用です。

public ref class ConstructorArgumentAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Property, AllowMultiple=false, Inherited=false)]
public sealed class ConstructorArgumentAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Property, AllowMultiple=false, Inherited=false)>]
type ConstructorArgumentAttribute = class
    inherit Attribute

Public NotInheritable Class ConstructorArgumentAttribute
Inherits Attribute

継承

Object

Attribute

ConstructorArgumentAttribute

属性

AttributeUsageAttribute

注釈

この属性は、関連付けられたプロパティをコンストラクター パラメーターで初期化できることを指定します。コンストラクターを使用してインスタンスを構築する場合は、XAML シリアル化では無視する必要があります。 これにより、パラメーターなしのコンストラクターのインスタンス化と特定の属性ではなく、パラメーター化されたコンストラクター構文のラウンド トリップ表現が向上します。

フレームワークは、シリアル化のためにオブジェクト ツリーの出力に依存するのではなく、マークアップ拡張機能の使用を ProvideValue 保持し、それらを再構成することをサポートできる可能性があります。 この場合、 ConstructorArgumentAttribute 情報はシリアル化中に役立ち、一般的なマークアップ拡張機能の使用を正確に表現できます。 マークアップ拡張機能について詳しくは、「 Markup Extensions for XAML Overview」をご覧ください。

属性に対 ConstructorArgumentAttribute して有効にするには、型のパブリック非パラメーターなしのコンストラクターで、1 つのパラメーターを正確にサポートする必要があります。 パラメーターの名前は、読み取り/書き込みプロパティに対応している必要があります。 それ以外の場合、 プロパティはシリアル化可能である必要があります。 この属性を使用して、コンストラクターの パラメーターの名前と プロパティの間の対応を作成します。 具体的には、接続している読み取り/書き込みプロパティのプロパティ レベル定義にこの属性を適用します。

の ConstructorArgumentAttribute コンシューマーは、型バッキングに解決されない場合 ArgumentName や、適切な構築引数とアリティを持たない型に適用された場合に をスローすることがあります。

以前のバージョンの.NET Frameworkでは、このクラスは WPF 固有のアセンブリ WindowsBase に存在しました。 .NET Framework 4 では、 ConstructorArgumentAttribute は System.Xaml アセンブリにあります。 詳細については、「 Types Migrated from WPF to System.Xaml」を参照してください。

WPF の使用上の注意

マークアップ拡張機能と WPF の詳細については、「 マークアップ拡張機能と WPF XAML」を参照してください。

コンストラクター

ConstructorArgumentAttribute(String)

ConstructorArgumentAttribute クラスの新しいインスタンスを初期化します。

プロパティ

ArgumentName	関連するプロパティを初期化するコンストラクターの 名前パラメーターを取得します。
TypeId	派生クラスで実装されると、この Attribute の一意の識別子を取得します。 (継承元 Attribute)

メソッド

Equals(Object)	このインスタンスが、指定されたオブジェクトと等価であるかどうかを示す値を返します。 (継承元 Attribute)
GetHashCode()	このインスタンスのハッシュ コードを返します。 (継承元 Attribute)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
IsDefaultAttribute()	派生クラスでオーバーライドされるとき、このインスタンスの値が派生クラスの既定値であるかどうかを示します。 (継承元 Attribute)
Match(Object)	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (継承元 Attribute)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

こちらもご覧ください

• MarkupExtension
• カスタム型とライブラリの XAML 関連の CLR 属性
• .NET XAML サービスで使用するカスタム型を定義する
• XAML サービス
• XAML の型コンバーターおよびマークアップ拡張機能