DependencyProperty.UnsetValue DependencyProperty.UnsetValue DependencyProperty.UnsetValue DependencyProperty.UnsetValue Field

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

Hinweise

UnsetValue ist ein Sentinelwert, die für Szenarien verwendet wird, in denen die WPFWPF ist nicht möglich, um eine angeforderte zu bestimmen, DependencyProperty Wert.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 verwendet, statt null, da null möglicherweise einen gültigen Eigenschaftswert als auch einen gültigen (und häufig verwendete) 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 niemals zurückgegeben, von DependencyObject.GetValue.UnsetValue is never returned out of DependencyObject.GetValue. Beim Aufruf DependencyObject.GetValue für eine Abhängigkeitseigenschaft auf einem DependencyObject Instanz angewendet wird, eine der folgenden:When you call DependencyObject.GetValue on a dependency property on a DependencyObject instance, one of the following applies:

  • Eine Abhängigkeitseigenschaft hat den Standardwert, der in den Metadaten eingerichtet, 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 vom Eigenschaftensystem hergestellt wurde, 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.

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

DependencyObject.ReadLocalValue Gibt 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, bei Verwendung als den Rückgabewert einer CoerceValueCallback.UnsetValue has a special meaning when used as the return value of a CoerceValueCallback. Weitere Informationen finden Sie unter Abhängigkeitsrückrufe und Validierung von.For details, see Dependency Property Callbacks and Validation.

Wenn Sie mit einer Datenbank binden, beachten Sie, dass UnsetValue ist nicht gleichbedeutend mit Value, auf ähnliche Weise wie Value ist nicht gleichbedeutend mit dem ein NULL-Wert "true".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: