Campo DependencyProperty.UnsetValue (System.Windows)

Cambia visualizzazione:
ScriptFree
Riferimento a .NET Framework
Campo DependencyProperty.UnsetValue
Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

Specifica un valore statico utilizzato dal sistema della proprietà WPF piuttosto che null per indicare che la proprietà esiste, ma non ha il valore impostato dal sistema della proprietà.

Spazio dei nomi:  System.Windows
Assembly:  WindowsBase (in WindowsBase.dll)
Sintassi

Visual Basic
Public Shared ReadOnly UnsetValue As Object
C#
public static readonly Object UnsetValue
Visual C++
public:
static initonly Object^ UnsetValue
F#
static val UnsetValue: Object

Valore di campo

Tipo: System.Object
Un valore di cui è stata annullata l'impostazione. Si tratta in effetti del risultato di una chiamata al costruttore Object.
Note

UnsetValue è un valore sentinel utilizzato per gli scenari in cui il sistema di proprietà WPF non è in grado di determinare un valore di DependencyProperty richiesto. Viene utilizzato UnsetValue anziché null perché null potrebbe essere un valore di proprietà valido, così come un valore valido (e utilizzato di frequente) di DefaultValue.

UnsetValue non è mai restituito fuori da DependencyObject.GetValue. Quando si chiama DependencyObject.GetValue su una proprietà di dipendenza su un'istanza DependencyObject, viene applicato uno degli elementi seguenti:

  • Una proprietà di dipendenza ha un valore predefinito stabilito nei metadati e quel valore è restituito. Questo valore potrebbe provenire da DefaultMetadata.

  • Alcuni altri valori sono stati stabiliti dal sistema della proprietà e il valore predefinito non è più pertinente. Per informazioni dettagliate, vedere Dependency Property Value Precedence.

L'Impostazione di DefaultValue di UnsetValue non è specificamente consentita.

DependencyObject.ReadLocalValue restituisce UnsetValue quando la proprietà richiesta non è stata impostata localmente.

UnsetValue ha un significato speciale se utilizzato come valore restituito di CoerceValueCallback. Per informazioni dettagliate, vedere Dependency Property Callbacks and Validation.

Se si sta eseguendo un'associazione a un database, notare che UnsetValue non è equivalente a Value, in modo simile a come Value non è equivalente a un vero null.

Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5, 3.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1
Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Vedere anche

Riferimenti

Altre risorse