ConstructorArgumentAttribute クラス

リファレンス

定義

名前空間:: System.Windows.Markup

アセンブリ:: WindowsBase.dll

アセンブリ:: System.Xaml.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

パラメーターなし以外のコンストラクター構文を使用してオブジェクトを初期化できることと、指定した名前のプロパティが構造情報を提供できることを指定します。この情報は主に 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)

明示的なインターフェイスの実装

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	一連の名前を対応する一連のディスパッチ識別子に割り当てます。 (継承元 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	オブジェクトの型情報を取得します。この情報はインターフェイスの型情報の取得に使用できます。 (継承元 Attribute)
_Attribute.GetTypeInfoCount(UInt32)	オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。 (継承元 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	オブジェクトによって公開されたプロパティおよびメソッドへのアクセスを提供します。 (継承元 Attribute)

適用対象

製品	バージョン
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

次の方法で共有