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.GetValue свойства зависимостей в экземпляре DependencyObject применяется одно из следующих действий:
Свойство зависимости имеет значение по умолчанию, установленное в метаданных, и это значение возвращается. Это значение может поступать из DefaultMetadata.
Система свойств установила другое значение, и значение по умолчанию больше не имеет значения. Дополнительные сведения см. в разделе Приоритет значений свойств зависимостей.
Установка объекта DefaultValueUnsetValue специально запрещена.
DependencyObject.ReadLocalValue возвращает значение UnsetValue , если запрошенное свойство не задано локально.
UnsetValue имеет особое значение при использовании в качестве возвращаемого CoerceValueCallbackзначения . Дополнительные сведения см. в разделе Обратные вызовы свойств зависимостей и проверка.
Если вы выполняете привязку к базе данных, обратите внимание, что UnsetValue это не эквивалентно Value, аналогично тому, как Value не эквивалентно значению true NULL.