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

UnsetValueist ein Sentinelwert, der für Szenarios verwendet WPFWPF wird, in denen das Eigenschaften System einen DependencyProperty angeforderten Wert nicht ermitteln kann.UnsetValue is a sentinel value that is used for scenarios where the WPFWPF property system is unable to determine a requested DependencyProperty value. UnsetValuewird anstelle nullvon verwendet, da null ein gültiger Eigenschafts Wert und ein gültiger (und häufig verwendeter) DefaultValueWert sein könnte.UnsetValue is used rather than null, because null could be a valid property value, as well as a valid (and frequently used) DefaultValue.

UnsetValuewird nie von DependencyObject.GetValuezurückgegeben.UnsetValue is never returned out of DependencyObject.GetValue. Wenn Sie für DependencyObject.GetValue eine Abhängigkeits Eigenschaft in einer DependencyObject -Instanz aufzurufen, 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 DefaultMetadatastammen.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 DefaultValue eines UnsetValue von ist ausdrücklich nicht zulässig.Setting a DefaultValue of UnsetValue is specifically disallowed.

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

UnsetValuehat eine besondere Bedeutung, wenn als Rückgabewert eines CoerceValueCallbackverwendet wird.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, UnsetValue beachten Sie, dass Valuenicht entspricht, und zwar auf ähnliche Value Weise, wie 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: