Поделиться через


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.

Применяется к