DependencyProperty.UnsetValue Champ
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.