DependencyProperty.UnsetValue Feld

Definition

Gibt einen statischen Wert an, der vom WPFWPF-Eigenschaftensystem verwendet wird, und nicht null, um anzugeben, dass die Eigenschaft vorhanden ist, der Wert jedoch nicht vom Eigenschaftensystem festgelegt wird.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 

Feldwert

Object

Hinweise

UnsetValue ist ein Sentinelwert, der für Szenarios verwendet wird, in denen das WPFWPF Eigenschaften System einen angeforderten Wert nicht ermitteln kann 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 wird anstelle von verwendet null , da null ein gültiger Eigenschafts Wert und ein gültiger (und häufig verwendeter) Wert sein könnte 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 wird nie von zurückgegeben DependencyObject.GetValue .UnsetValue is never returned out of DependencyObject.GetValue. Wenn Sie DependencyObject.GetValue für eine Abhängigkeits Eigenschaft in einer-Instanz aufzurufen DependencyObject , gilt eine der folgenden Aktionen:When you call DependencyObject.GetValue on a dependency property on a DependencyObject instance, one of the following applies:

  • Für eine Abhängigkeits Eigenschaft wird ein Standardwert in den Metadaten festgelegt, und dieser Wert wird zurückgegeben.A dependency property has a default value established in metadata and that value is returned. Dieser Wert kann aus stammen DefaultMetadata .This value might come from DefaultMetadata.

  • Ein anderer Wert wurde durch das Eigenschaften System festgelegt, und der Standardwert ist nicht mehr relevant.Some other value was established by the property system, and the default value is no longer relevant. Weitere Informationen finden Sie unter Priorität von Abhängigkeitseigenschaftswerten.For details, see Dependency Property Value Precedence.

Das Festlegen eines DefaultValue von UnsetValue ist ausdrücklich nicht zulässig.Setting a DefaultValue of UnsetValue is specifically disallowed.

DependencyObject.ReadLocalValue Gibt zurück, UnsetValue Wenn die angeforderte Eigenschaft nicht lokal festgelegt wurde.DependencyObject.ReadLocalValue returns UnsetValue when the requested property has not been locally set.

UnsetValue hat eine besondere Bedeutung, wenn als Rückgabewert eines verwendet wird CoerceValueCallback .UnsetValue has a special meaning when used as the return value of a CoerceValueCallback. Weitere Informationen finden Sie unter Rückrufe und Validierung von Abhängigkeits Eigenschaften.For details, see Dependency Property Callbacks and Validation.

Wenn Sie eine Bindung an eine Datenbank durchlaufen, beachten Sie, dass UnsetValue nicht entspricht Value , und zwar auf ähnliche Weise, wie Value nicht mit einem true NULL-Wert identisch ist.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.

Gilt für: