Partager via


DependencyProperty.UnsetValue Champ

Définition

Spécifie une valeur statique qui est utilisée par le système de propriétés WPF plutôt que null pour indiquer que la propriété existe, mais dont la valeur n’est pas définie par le système de propriétés.

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

UnsetValue est une valeur sentinelle utilisée pour les scénarios où le système de propriétés WPF ne peut pas déterminer une valeur demandée DependencyProperty . UnsetValue est utilisé plutôt que null, car null peut être une valeur de propriété valide, ainsi qu’un valide (et fréquemment utilisé) DefaultValue.

UnsetValue n’est jamais retourné à partir de DependencyObject.GetValue. Lorsque vous appelez DependencyObject.GetValue sur une propriété de dépendance sur un DependencyObject instance, l’une des opérations suivantes s’applique :

  • Une propriété de dépendance a une valeur par défaut établie dans les métadonnées et cette valeur est retournée. Cette valeur peut provenir de 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. Pour plus d’informations, consultez Priorité de la valeur de propriété de dépendance.

La définition d’un DefaultValue de UnsetValue est spécifiquement interdite.

DependencyObject.ReadLocalValue retourne UnsetValue lorsque la propriété demandée n’a pas été définie localement.

UnsetValue a une signification spéciale lorsqu’il est utilisé comme valeur de retour d’un CoerceValueCallback. Pour plus d’informations, consultez Rappels et validation des propriétés de dépendance.

Si vous liez à une base de données, notez que n’est pas équivalent à Value, de la même façon que UnsetValue n’est Value pas équivalent à une valeur null vraie.

S’applique à