DependencyProperty.UnsetValue Feld

Definition

Namespace:

System.Windows

Assembly:

WindowsBase.dll

Gibt einen statischen Wert an, der vom WPF-Eigenschaftensystem verwendet wird, anstatt null anzugeben, dass die Eigenschaft vorhanden ist, aber nicht vom Eigenschaftensystem festgelegt wird.

public: static initonly System::Object ^ UnsetValue;

public static readonly object UnsetValue;

 staticval mutable UnsetValue : obj

Public Shared ReadOnly UnsetValue As Object 

Feldwert

Object

Hinweise

UnsetValue ist ein Sentinelwert, der für Szenarien verwendet wird, in denen das WPF-Eigenschaftssystem einen angeforderten DependencyProperty Wert nicht ermitteln kann. UnsetValue wird anstelle nullvon verwendet, da null es sich um einen gültigen Eigenschaftswert sowie um einen gültigen (und häufig verwendeten) DefaultValuesein könnte.

UnsetValue wird nie aus DependencyObject.GetValuezurückgegeben. Wenn Sie eine Abhängigkeitseigenschaft für eine DependencyObject instance aufrufenDependencyObject.GetValue, gilt eine der folgenden Aktionen:

• Eine Abhängigkeitseigenschaft verfügt über einen Standardwert, der in den Metadaten festgelegt ist, und dieser Wert wird zurückgegeben. Dieser Wert kann von DefaultMetadatastammen.

• Ein anderer Wert wurde vom Eigenschaftensystem festgelegt, und der Standardwert ist nicht mehr relevant. Weitere Informationen finden Sie unter Priorität von Abhängigkeitseigenschaftswerten.

Das Festlegen eines DefaultValue von UnsetValue ist ausdrücklich nicht zulässig.

DependencyObject.ReadLocalValue gibt zurück UnsetValue , wenn die angeforderte Eigenschaft nicht lokal festgelegt wurde.

UnsetValue hat eine besondere Bedeutung, wenn es als Rückgabewert eines CoerceValueCallbackverwendet wird. Weitere Informationen finden Sie unter Rückrufe und Validierung von Abhängigkeitseigenschaften.

Wenn Sie eine Bindung an eine Datenbank durchführen, beachten Sie, dass UnsetValue nicht gleichbedeutend Valuemit ist, in ähnlicher Weise wie Value dies nicht mit einem true NULL-Wert identisch ist.