DependencyProperty.UnsetValue Pole

Definicja

Określa wartość statyczną używaną przez system właściwości WPF zamiast null wskazywać, że właściwość istnieje, ale nie ma jej wartości ustawionej przez system właściwości.

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

Wartość pola

Uwagi

UnsetValue to wartość sentinel używana w scenariuszach, w których system właściwości WPF nie może określić żądanej DependencyProperty wartości. UnsetValue jest używana zamiast null, ponieważ null może być prawidłową wartością właściwości, a także prawidłową (i często używaną) DefaultValuewartością .

UnsetValue nigdy nie jest zwracany z DependencyObject.GetValueobiektu . Podczas wywoływania DependencyObject.GetValue właściwości zależności w DependencyObject wystąpieniu ma zastosowanie jeden z następujących elementów:

  • Właściwość zależności ma wartość domyślną ustanowioną w metadanych i zwracaną wartość. Ta wartość może pochodzić z DefaultMetadataelementu .

  • Inna wartość została ustanowiona przez system właściwości, a wartość domyślna nie jest już odpowiednia. Aby uzyskać szczegółowe informacje, zobacz Pierwszeństwo wartości właściwości zależności.

Ustawienie elementu UnsetValue jest DefaultValue specjalnie niedozwolone.

DependencyObject.ReadLocalValue zwraca wartość UnsetValue , gdy żądana właściwość nie została ustawiona lokalnie.

UnsetValue ma specjalne znaczenie, gdy jest używane jako wartość zwracana CoerceValueCallbackelementu . Aby uzyskać szczegółowe informacje, zobacz Wywołania zwrotne właściwości zależności i walidacja.

Jeśli wiążesz się z bazą danych, pamiętaj, że UnsetValue nie jest to odpowiednik metody , w podobny sposób, jak Value nie jest równoważne Valueprawdziwej wartości null.

Dotyczy