DependencyProperty.UnsetValue Campo

Definizione

Specifica un valore statico utilizzato dal sistema della proprietà WPFWPF piuttosto che null per indicare che la proprietà esiste, ma non ha il valore impostato dal sistema della proprietà.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 

Valore del campo

Object

Commenti

UnsetValue è un valore sentinella utilizzato per gli scenari in cui il WPFWPF sistema di proprietà non è in grado di determinare un DependencyProperty valore richiesto.UnsetValue is a sentinel value that is used for scenarios where the WPFWPF property system is unable to determine a requested DependencyProperty value. UnsetValue viene usato anziché null , perché null potrebbe essere un valore di proprietà valido, oltre a un oggetto valido (e usato di frequente) 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 non viene mai restituito da DependencyObject.GetValue .UnsetValue is never returned out of DependencyObject.GetValue. Quando si chiama DependencyObject.GetValue su una proprietà di dipendenza in un' DependencyObject istanza di, si applica una delle condizioni seguenti:When you call DependencyObject.GetValue on a dependency property on a DependencyObject instance, one of the following applies:

  • Una proprietà di dipendenza dispone di un valore predefinito stabilito nei metadati e viene restituito tale valore.A dependency property has a default value established in metadata and that value is returned. Questo valore può provenire da DefaultMetadata .This value might come from DefaultMetadata.

  • Un altro valore è stato stabilito dal sistema di proprietà e il valore predefinito non è più pertinente.Some other value was established by the property system, and the default value is no longer relevant. Per altri dettagli, vedere Precedenza del valore della proprietà di dipendenza.For details, see Dependency Property Value Precedence.

L'impostazione DefaultValue di un di UnsetValue è non consentita in modo specifico.Setting a DefaultValue of UnsetValue is specifically disallowed.

DependencyObject.ReadLocalValue restituisce UnsetValue quando la proprietà richiesta non è stata impostata localmente.DependencyObject.ReadLocalValue returns UnsetValue when the requested property has not been locally set.

UnsetValue ha un significato speciale quando viene usato come valore restituito di un oggetto CoerceValueCallback .UnsetValue has a special meaning when used as the return value of a CoerceValueCallback. Per informazioni dettagliate, vedere callback e convalida delle proprietà di dipendenza.For details, see Dependency Property Callbacks and Validation.

Se si esegue l'associazione a un database, si noti che UnsetValue non equivale a Value , in modo analogo a come Value non equivale a un valore null 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.

Si applica a