DependencyPropertyKey 类

定义

public ref class DependencyPropertyKey sealed

public sealed class DependencyPropertyKey

type DependencyPropertyKey = class

Public NotInheritable Class DependencyPropertyKey

继承

Object

DependencyPropertyKey

示例

下面的示例将注册一个只读依赖属性，并将该密钥用于其他类成员中的两个目的：实现 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.

不应将由只读依赖项属性注册返回的 DependencyPropertyKey 设置为公共的，因为公开密钥会使属性可设置，因此摆将其注册为只读依赖属性的点。The 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.

应将 DependencyPropertyKey DependencyProperty 值作为类的 public static readonlyDependencyProperty 公开，而不是公开密钥本身。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