DependencyProperty.OverrideMetadata メソッド

public:
 void OverrideMetadata(Type ^ forType, System::Windows::PropertyMetadata ^ typeMetadata);

public void OverrideMetadata (Type forType, System.Windows.PropertyMetadata typeMetadata);

member this.OverrideMetadata : Type * System.Windows.PropertyMetadata -> unit

Public Sub OverrideMetadata (forType As Type, typeMetadata As PropertyMetadata)

パラメーター

例外

注釈

プロパティ システムが依存関係プロパティを使用する前に、依存関係プロパティのメタデータをオーバーライドする必要があります。 これは、依存関係プロパティを登録する クラスを使用して特定のインスタンスが作成される時間と同じです。 の OverrideMetadata 呼び出しは、このメソッドのパラメーターとして forType それ自体を提供する型の静的コンストラクター内、または同様のインスタンス化によってのみ実行する必要があります。 所有者型のインスタンスが存在した後にメタデータを変更しようとすると、例外は発生しませんが、プロパティ システムで動作が矛盾します。

このメソッドを使用して特定の派生クラスオーバーライドのメタデータが確立された後、この同じ派生クラスでメタデータをオーバーライドしようとすると、例外が発生します。

指定されたメタデータは、基本所有者に存在するため、依存関係プロパティのプロパティ メタデータとマージされます。 元の基本メタデータで指定された特性はすべて保持されます。新しいメタデータで特に変更された特性のみが、基本メタデータの特性をオーバーライドします。 などの DefaultValue 一部の特性は、新しいメタデータで指定されている場合に置き換えられます。 などの PropertyChangedCallback他の が組み合わされます。 最終的には、マージ動作はオーバーライドに使用されるプロパティ メタデータ型に依存するため、ここで説明する動作は、WPF 依存関係プロパティによって使用される既存のプロパティ メタデータ クラスに対するものです。 詳細については、「 依存関係プロパティのメタデータ 」と 「フレームワーク プロパティ メタデータ」を参照してください。

public:
 void OverrideMetadata(Type ^ forType, System::Windows::PropertyMetadata ^ typeMetadata, System::Windows::DependencyPropertyKey ^ key);

public void OverrideMetadata (Type forType, System.Windows.PropertyMetadata typeMetadata, System.Windows.DependencyPropertyKey key);

member this.OverrideMetadata : Type * System.Windows.PropertyMetadata * System.Windows.DependencyPropertyKey -> unit

Public Sub OverrideMetadata (forType As Type, typeMetadata As PropertyMetadata, key As DependencyPropertyKey)

パラメーター

注釈

このシグネチャは、読み取り専用の依存関係プロパティ識別子 (DependencyPropertyKey) メソッドの基になる実装を提供します。 読み取り/書き込み依存関係プロパティのメタデータをオーバーライドする場合は、 を使用します OverrideMetadata(Type, PropertyMetadata)。

プロパティ システムが依存関係プロパティを使用する前に、依存関係プロパティのメタデータをオーバーライドする必要があります。 これは、依存関係プロパティを登録するクラスに対して特定のオブジェクトが作成される時間と同じです。 の OverrideMetadata 呼び出しは、このメソッドのパラメーターとして forType それ自体を提供する型の静的コンストラクター内、または同様のインスタンス化によってのみ実行する必要があります。 所有者型のインスタンスが存在した後にメタデータを変更しようとすると、例外は発生しませんが、プロパティ システムで動作が矛盾します。

このメソッドを使用して特定の派生クラスオーバーライドのメタデータが確立された後、この同じ派生クラスでメタデータをオーバーライドしようとすると、例外が発生します。

指定されたメタデータは、基本所有者に存在するため、依存関係プロパティのプロパティ メタデータとマージされます。 元の基本メタデータで指定された特性はすべて保持されます。新しいメタデータで特に変更された特性のみが、基本メタデータの特性をオーバーライドします。 などの DefaultValue 一部の特性は、新しいメタデータで指定されている場合に置き換えられます。 などの PropertyChangedCallback他の が組み合わされます。 マージ動作は、オーバーライドに使用されるプロパティ メタデータ型によって異なります。 詳細については、「 依存関係プロパティのメタデータ 」と 「フレームワーク プロパティ メタデータ」を参照してください。