DependencyProperty.UnsetValue Pole
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.