DependencyPropertyKey クラス

定義

名前空間:

System.Windows

アセンブリ:

WindowsBase.dll

読み取り専用の依存関係プロパティへの制限付き書き込みアクセスの依存関係プロパティ識別子を提供します。

public ref class DependencyPropertyKey sealed

public sealed class DependencyPropertyKey

type DependencyPropertyKey = class

Public NotInheritable Class DependencyPropertyKey

継承

Object

DependencyPropertyKey

例

次の例では、読み取り専用の依存関係プロパティを登録し、他のクラス メンバーの 2 つの目的にもキーを使用します。get "ラッパー" を実装し、他のプロパティ値の計算に基づいて値を設定する保護された決定操作の識別子として使用します。

internal static readonly DependencyPropertyKey AquariumSizeKey = DependencyProperty.RegisterReadOnly(
  "AquariumSize",
  typeof(double),
  typeof(Aquarium),
  new PropertyMetadata(double.NaN)
);
public static readonly DependencyProperty AquariumSizeProperty =
  AquariumSizeKey.DependencyProperty;
public double AquariumSize
{
  get { return (double)GetValue(AquariumSizeProperty); }
}

Friend Shared ReadOnly AquariumSizeKey As DependencyPropertyKey = DependencyProperty.RegisterReadOnly("AquariumSize", GetType(Double), GetType(Aquarium), New PropertyMetadata(Double.NaN))
Public Shared ReadOnly AquariumSizeProperty As DependencyProperty = AquariumSizeKey.DependencyProperty
Public ReadOnly Property AquariumSize() As Double
    Get
        Return CDbl(GetValue(AquariumSizeProperty))
    End Get
End Property

注釈

DependencyPropertyKey インスタンスは、RegisterReadOnly または RegisterAttachedReadOnlyメソッドを使用して、依存関係プロパティ登録呼び出しの戻り値として取得されます。

依存関係プロパティを登録する型は、クラス ロジックの一部としてプロパティの値を調整する SetValue と ClearValue の呼び出しで DependencyPropertyKey を使用できます。 キーのアクセス レベルで許可されている場合、関連するクラスはキーと依存関係プロパティも使用できます。 たとえば、キーを内部として宣言できます。また、同じアセンブリ内の他の型でも、その依存関係プロパティを設定できます。

キーを公開するとプロパティが設定可能になり、読み取り専用の依存関係プロパティとして登録するポイントが無効になるため、読み取り専用の依存関係プロパティの登録によって返される DependencyPropertyKey を公開しないでください。 また、キーを公開すると、使用可能な依存関係プロパティの動作とその共通言語ランタイム (CLR) プロパティ ラッパー実装の間で不一致が発生します。これは、クラスの設計が不適切です。

キー自体を公開する代わりに、DependencyPropertyKey の DependencyProperty 値をクラスの public static readonlyDependencyProperty として公開する必要があります。 これにより、プロパティは、ローカルに設定された値の列挙など、特定のプロパティ システム操作の有効な依存関係プロパティ識別子を返すことができます。 ただし、このように取得された識別子には、多くのプロパティ システム操作に対する DependencyProperty の完全な機能がありません。

プロパティ

DependencyProperty

この特殊な読み取り専用の依存関係プロパティ識別子に関連付けられている依存関係プロパティ識別子を取得します。

メソッド

Equals(Object)	指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
OverrideMetadata(Type, PropertyMetadata)	この依存関係プロパティ識別子によって表される読み取り専用の依存関係プロパティのメタデータをオーバーライドします。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

こちらもご覧ください

• DependencyProperty