DependencyProperty.UnsetValue Поле

Определение

Задает статическое значение, используемое системой свойств WPFWPF вместо null для указания того, что свойство существует, но его значение не задано системой свойств.Specifies a static value that is used by the WPFWPF property system rather than null to indicate that the property exists, but does not have its value set by the property system.

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

Значение поля

Комментарии

UnsetValue — это значение Sentinel, которое используется в сценариях, где система свойств WPFWPF не может определить запрошенное значение DependencyProperty.UnsetValue is a sentinel value that is used for scenarios where the WPFWPF property system is unable to determine a requested DependencyProperty value. UnsetValue используется вместо null, так как null может быть допустимым значением свойства, а также допустимым (и часто используемым) DefaultValue.UnsetValue is used rather than null, because null could be a valid property value, as well as a valid (and frequently used) DefaultValue.

UnsetValue никогда не возвращается из DependencyObject.GetValue.UnsetValue is never returned out of DependencyObject.GetValue. При вызове DependencyObject.GetValue для свойства зависимости в экземпляре DependencyObject применяется одно из следующих условий:When you call DependencyObject.GetValue on a dependency property on a DependencyObject instance, one of the following applies:

  • Свойство зависимостей имеет значение по умолчанию, установленное в метаданных и возвращаемое значение.A dependency property has a default value established in metadata and that value is returned. Это значение может быть получено из DefaultMetadata.This value might come from DefaultMetadata.

  • Другое значение было установлено системой свойств, и значение по умолчанию больше не применяется.Some other value was established by the property system, and the default value is no longer relevant. Дополнительные сведения см. в разделе Приоритет значений свойств зависимостей.For details, see Dependency Property Value Precedence.

Явное задание DefaultValue UnsetValue запрещено.Setting a DefaultValue of UnsetValue is specifically disallowed.

DependencyObject.ReadLocalValue возвращает UnsetValue, если запрошенное свойство не задано локально.DependencyObject.ReadLocalValue returns UnsetValue when the requested property has not been locally set.

UnsetValue имеет специальное значение при использовании в качестве возвращаемого значения CoerceValueCallback.UnsetValue has a special meaning when used as the return value of a CoerceValueCallback. Дополнительные сведения см. в разделе обратные вызовы и проверка свойства зависимостей.For details, see Dependency Property Callbacks and Validation.

При привязке к базе данных обратите внимание, что UnsetValue не эквивалентно Value, аналогично тому, как Value не эквивалентно значению true null.If you are binding to a database, note that UnsetValue is not equivalent to Value, in a similar way to how Value is not equivalent to a true null.

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