DependencyProperty.UnsetValue 字段

定义

指定一个静态值,该值由 WPF 属性系统使用,而不是 null 指示该属性存在,但不由属性系统设置其值。

public: static initonly System::Object ^ UnsetValue;
public static readonly object UnsetValue;
 staticval mutable UnsetValue : obj
Public Shared ReadOnly UnsetValue As Object 

字段值

注解

UnsetValue 是一个 sentinel 值,用于 WPF 属性系统无法确定请求 DependencyProperty 的值的情况。 UnsetValue 使用 而不是 null,因为 null 可以是有效的属性值,以及有效的 (并且经常使用) DefaultValue

UnsetValue 永远不会从 中返回 DependencyObject.GetValue。 对实例的依赖属性DependencyObject调用 DependencyObject.GetValue 时,下列其中一项适用:

  • 依赖属性具有在元数据中建立的默认值,并返回该值。 此值可能来自 DefaultMetadata

  • 其他一些值由属性系统建立,默认值不再相关。 有关详细信息,请参阅依赖属性值优先级

DefaultValue特别禁止设置 的 UnsetValue

DependencyObject.ReadLocalValueUnsetValue未在本地设置请求的属性时返回 。

UnsetValue 用作 的 CoerceValueCallback返回值时具有特殊含义。 有关详细信息,请参阅 依赖属性回调和验证

如果要绑定到数据库,请注意, UnsetValue 不等效于 Value,其方式 Value 与 不等效于 true null 的方式类似。

适用于