DependencyPropertyKey クラス

定義

public ref class DependencyPropertyKey sealed

public sealed class DependencyPropertyKey

type DependencyPropertyKey = class

Public NotInheritable Class DependencyPropertyKey

継承

Object

DependencyPropertyKey

例

次の例では、読み取り専用の依存関係プロパティを登録し、他のクラスメンバーの2つの目的でキーを使用します。 get "ラッパー" の実装と、計算に基づいて値を設定する、保護された決定操作の識別子として使用します。他のプロパティ値の。The following example registers a read-only dependency property, and also uses the key for two purposes in other class members: implementing the get "wrapper", and as the identifier for a protected determination operation that sets the value based on calculations of other property values.

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を使用して、依存関係プロパティの登録呼び出しの戻り値として取得されます。DependencyPropertyKey instances are obtained as the return value of a dependency property registration call using the methods RegisterReadOnly or RegisterAttachedReadOnly.

依存関係プロパティを登録する型は、のDependencyPropertyKey SetValue呼び出しClearValueでを使用し、プロパティの値をクラスロジックの一部として調整できます。The types that register a dependency property can use the DependencyPropertyKey in calls to SetValue and ClearValue that adjust the property's value as part of class logic. キーのアクセスレベルで許可されている場合、関連するクラスはキーと依存関係プロパティも使用できます。If permitted by the access level of the key, related classes can use the key and the dependency property also. たとえば、キーを内部として宣言し、同じアセンブリ内の他の型もその依存関係プロパティを設定できます。For instance, you can declare the key as internal, and other types within the same assembly can also set that dependency property.

読み取り専用の依存関係プロパティの登録によって返されるをパブリックにすることはできません。キーを公開すると、プロパティが設定可能になるため、読み取り専用の依存関係プロパティとして登録するポイントが無効になります。DependencyPropertyKeyThe DependencyPropertyKey returned by read-only dependency property registration should not be made public, because exposing the key makes the property settable, thus defeating the point of registering it as a read-only dependency property. また、キーを公開すると、使用可能な依存関係プロパティの動作共通言語ランタイム (CLR)common language runtime (CLR)とプロパティラッパーの実装が一致しません。これは、クラスの設計が不適切であることを示します。Also, exposing the key causes a mismatch between the available dependency property behaviors and its 共通言語ランタイム (CLR)common language runtime (CLR) property wrapper implementations, which is bad class design.

代わりに、キー自体を公開するのではなく、 DependencyProperty DependencyPropertyKeyの値をクラスのpublic static readonlyとしてDependencyProperty公開する必要があります。Instead of exposing the key itself, you should instead expose the DependencyProperty value of the DependencyPropertyKey as a public static readonlyDependencyProperty on your class. これにより、プロパティは、ローカルに設定された値の列挙など、特定のプロパティシステム操作に対して有効な依存関係プロパティ識別子を返すことができます。This enables the property to return a valid dependency property identifier for certain property system operations such as enumerating locally set values. ただし、取得した識別子には、多くのプロパティシステム操作DependencyPropertyに対するの完全な機能はありません。However, the identifier thus obtained does not have the full capabilities of a DependencyProperty for many property system operations.

プロパティ

メソッド

適用対象

こちらもご覧ください

• DependencyProperty