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

Commenti

UnsetValue è un valore sentinella utilizzato per gli scenari in cui il sistema di proprietà WPFWPF non è in grado di determinare un valore DependencyProperty 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 può essere un valore di proprietà valido, oltre a un DefaultValuevalido (e usato di frequente).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 restituita DependencyObject.GetValue.UnsetValue is never returned out of DependencyObject.GetValue. Quando si chiama DependencyObject.GetValue su una proprietà di dipendenza in un'istanza di DependencyObject, 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 di una DefaultValue di UnsetValue non è consentita in modo specifico.Setting a DefaultValue of UnsetValue is specifically disallowed.

DependencyObject.ReadLocalValue restituisce UnsetValue se 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 se usato come valore restituito di un 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 sta associando a un database, si noti che UnsetValue non è equivalente a Value, in modo analogo a come Value non è equivalente a un vero valore 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.

Si applica a