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

Définition

Spécifie une valeur statique qui est utilisée par le système de propriétés WPFWPF plutôt que null pour indiquer que la propriété existe, mais sa valeur n'est pas définie par le système de propriétés.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 

Valeur de champ

Remarques

UnsetValueest une valeur de sentinelle qui est utilisée pour les scénarios WPFWPF où le système de propriétés n’est pas DependencyProperty en mesure de déterminer une valeur demandée.UnsetValue is a sentinel value that is used for scenarios where the WPFWPF property system is unable to determine a requested DependencyProperty value. UnsetValueest utilisé au lieu nullde, null car peut être une valeur de propriété valide, ainsi qu’un valide (et fréquemment utilisé DefaultValue).UnsetValue is used rather than null, because null could be a valid property value, as well as a valid (and frequently used) DefaultValue.

UnsetValuen’est jamais retourné à DependencyObject.GetValuepartir de.UnsetValue is never returned out of DependencyObject.GetValue. Lorsque vous appelez DependencyObject.GetValue sur une propriété de dépendance sur DependencyObject une instance, l’une des conditions suivantes s’applique:When you call DependencyObject.GetValue on a dependency property on a DependencyObject instance, one of the following applies:

  • Une propriété de dépendance a une valeur par défaut définie dans les métadonnées et cette valeur est retournée.A dependency property has a default value established in metadata and that value is returned. Cette valeur peut provenir DefaultMetadatade.This value might come from DefaultMetadata.

  • Une autre valeur a été établie par le système de propriétés, et la valeur par défaut n’est plus pertinente.Some other value was established by the property system, and the default value is no longer relevant. Pour plus d’informations, consultez Priorité de la valeur de propriété de dépendance.For details, see Dependency Property Value Precedence.

La définition DefaultValue d' UnsetValue un de est spécifiquement interdite.Setting a DefaultValue of UnsetValue is specifically disallowed.

DependencyObject.ReadLocalValueretourne UnsetValue lorsque la propriété demandée n’a pas été définie localement.DependencyObject.ReadLocalValue returns UnsetValue when the requested property has not been locally set.

UnsetValuea une signification spéciale lorsqu’il est utilisé comme valeur de retour CoerceValueCallbackd’un.UnsetValue has a special meaning when used as the return value of a CoerceValueCallback. Pour plus d’informations, consultez validation et rappels de propriétés de dépendance.For details, see Dependency Property Callbacks and Validation.

Si vous effectuez une liaison à une base de données UnsetValue , Notez que n' Valueest pas équivalent à, d’une Value manière similaire à la façon dont n’est pas équivalent à une valeur true null.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.

S’applique à