DependencyProperty.UnsetValue Feld

Definition

Gibt einen statischen Wert an, der vom WPF-Eigenschaftssystem null verwendet wird, anstatt anzugeben, dass die Eigenschaft vorhanden ist, aber nicht über den Wert des Eigenschaftssystems 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 keinen angeforderten DependencyProperty Wert bestimmen kann. UnsetValuenullwird anstelle von , da null es sich um einen gültigen Eigenschaftswert sowie um einen gültigen (und häufig verwendeten) DefaultValueWert handelt.

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

  • Eine Abhängigkeitseigenschaft weist einen Standardwert auf, der in Metadaten festgelegt ist und dieser Wert zurückgegeben wird. Dieser Wert kann von .DefaultMetadata

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

Die Einstellung 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 sie als Rückgabewert eines CoerceValueCallback. Ausführliche Informationen finden Sie unter Dependency Property Callbacks und Validation.

Wenn Sie eine Bindung an eine Datenbank haben, beachten Sie, dass es UnsetValue sich nicht Valueum eine ähnliche Art und Weise handelt, wie Value eine true Null nicht entspricht.

Gilt für: