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

Hinweise

UnsetValue ist ein Sentinelwert, der für Szenarios verwendet wird, in denen das WPFWPF-Eigenschaften System einen angeforderten DependencyProperty 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. UnsetValue wird anstelle von nullverwendet, da null ein gültiger Eigenschafts Wert und ein gültiger (und häufig verwendeter) DefaultValuesein können.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 DependencyObject.GetValuezurückgegeben.UnsetValue is never returned out of DependencyObject.GetValue. Wenn Sie DependencyObject.GetValue für eine Abhängigkeits Eigenschaft in einer DependencyObject Instanz von abrufen, 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 einer DefaultValue von UnsetValue ist ausdrücklich nicht zulässig.Setting a DefaultValue of UnsetValue is specifically disallowed.

DependencyObject.ReadLocalValue gibt UnsetValue zurück, 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 er 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, beachten Sie, dass UnsetValue nicht mit Valueidentisch ist, ähnlich wie Value nicht mit dem Wert true Null übereinstimmt.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: