DependencyProperty.UnsetValue Alan

Tanım

Özelliğin var olduğunu göstermek yerine özellik sistemi tarafından kullanılan statik bir değeri belirtir WPFWPF null , ancak özelliğin değeri özellik sistemi tarafından ayarlanmış değildir.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 

Alan Değeri

Object

Açıklamalar

UnsetValue , WPFWPF özellik sisteminin istenen değeri belirleyemediğini gösteren senaryolar için kullanılan Sentinel değeridir DependencyProperty .UnsetValue is a sentinel value that is used for scenarios where the WPFWPF property system is unable to determine a requested DependencyProperty value. UnsetValue yerine kullanılır null , çünkü geçerli bir null özellik değeri, ayrıca geçerli bir (ve sık kullanılan) olabilir 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 hiç hiçbir şekilde alınmadı DependencyObject.GetValue .UnsetValue is never returned out of DependencyObject.GetValue. DependencyObject.GetValueBir örnekteki bağımlılık özelliğini çağırdığınızda DependencyObject , aşağıdakilerden biri geçerlidir:When you call DependencyObject.GetValue on a dependency property on a DependencyObject instance, one of the following applies:

  • Dependency özelliğinin meta verilerde varsayılan bir değeri oluşturulur ve bu değer döndürülür.A dependency property has a default value established in metadata and that value is returned. Bu değer, öğesinden gelebilir DefaultMetadata .This value might come from DefaultMetadata.

  • Özellik sistemi tarafından başka bir değer oluşturulmuştur ve varsayılan değer artık ilgili değildir.Some other value was established by the property system, and the default value is no longer relevant. Ayrıntılar için bkz. bağımlılık özelliği değer önceliği.For details, see Dependency Property Value Precedence.

Öğesinin ayarına DefaultValue UnsetValue özellikle izin verilmez.Setting a DefaultValue of UnsetValue is specifically disallowed.

DependencyObject.ReadLocalValueUnsetValueistenen özellik yerel olarak ayarlanmamışsa döndürür.DependencyObject.ReadLocalValue returns UnsetValue when the requested property has not been locally set.

UnsetValue öğesinin dönüş değeri olarak kullanıldığında özel bir anlamı vardır CoerceValueCallback .UnsetValue has a special meaning when used as the return value of a CoerceValueCallback. Ayrıntılar için bkz. bağımlılık özelliği geri çağırmaları ve doğrulama.For details, see Dependency Property Callbacks and Validation.

Bir veritabanına bağlıyorsanız, UnsetValue Value Value doğru bir null değere eşdeğer olmayan bir şekilde, ile eşdeğer olmadığını unutmayın.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.

Şunlara uygulanır