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

Definición

Especifica un valor estático que usa el sistema de propiedades de WPFWPF en vez de null para indicar que la propiedad existe, pero el sistema de propiedades no ha establecido su valor.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 

Valor de campo

Comentarios

UnsetValue es un valor de centinela que se utiliza para escenarios donde el WPFWPF sistema de propiedades no puede determinar un solicitado DependencyProperty valor.UnsetValue is a sentinel value that is used for scenarios where the WPFWPF property system is unable to determine a requested DependencyProperty value. UnsetValue se usa en lugar de null, porque null podría ser un valor de propiedad válido, así como válido (y de uso frecuente) DefaultValue.UnsetValue is used rather than null, because null could be a valid property value, as well as a valid (and frequently used) DefaultValue.

UnsetValue no se devuelve nunca fuera de DependencyObject.GetValue.UnsetValue is never returned out of DependencyObject.GetValue. Cuando se llama a DependencyObject.GetValue en una propiedad de dependencia en un DependencyObject instancia, los siguientes casos:When you call DependencyObject.GetValue on a dependency property on a DependencyObject instance, one of the following applies:

  • Una propiedad de dependencia tiene un valor predeterminado establecido en los metadatos y se devuelve ese valor.A dependency property has a default value established in metadata and that value is returned. Este valor podría proceder de DefaultMetadata.This value might come from DefaultMetadata.

  • Algún otro valor se estableció con el sistema de propiedades y el valor predeterminado ya no es relevante.Some other value was established by the property system, and the default value is no longer relevant. Para obtener más información, consulte Prioridad de los valores de propiedades de dependencia.For details, see Dependency Property Value Precedence.

Establecer un DefaultValue de UnsetValue específicamente no está permitida.Setting a DefaultValue of UnsetValue is specifically disallowed.

DependencyObject.ReadLocalValue Devuelve UnsetValue cuando la propiedad solicitada no se ha establecido localmente.DependencyObject.ReadLocalValue returns UnsetValue when the requested property has not been locally set.

UnsetValue tiene un significado especial cuando se usa como el valor devuelto de un CoerceValueCallback.UnsetValue has a special meaning when used as the return value of a CoerceValueCallback. Para obtener más información, consulte devoluciones de llamada y validación.For details, see Dependency Property Callbacks and Validation.

Si va a enlazar a una base de datos, tenga en cuenta que UnsetValue no es equivalente a Value, de forma similar a cómo Value no es equivalente a un valor null es true.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.

Se aplica a