DependencyPropertyKey クラス

定義

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