DependencyProperty.UnsetValue Campo

Definição

Especifica um valor estático que é usado pelo sistema da propriedade WPFWPF em vez de null para indicar que a propriedade existe, mas não tem seu valor definido pelo sistema da propriedade.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 do campo

Comentários

UnsetValue é um valor de sentinela usado para cenários em que o sistema de propriedades WPFWPF não pode determinar um valor de DependencyProperty solicitado.UnsetValue is a sentinel value that is used for scenarios where the WPFWPF property system is unable to determine a requested DependencyProperty value. UnsetValue é usado em vez de null, porque null pode ser um valor de propriedade válido, bem como um DefaultValueválido (e frequentemente usado).UnsetValue is used rather than null, because null could be a valid property value, as well as a valid (and frequently used) DefaultValue.

UnsetValue nunca é retornado de DependencyObject.GetValue.UnsetValue is never returned out of DependencyObject.GetValue. Quando você chama DependencyObject.GetValue em uma propriedade de dependência em uma instância DependencyObject, um dos seguintes se aplica:When you call DependencyObject.GetValue on a dependency property on a DependencyObject instance, one of the following applies:

  • Uma propriedade de dependência tem um valor padrão estabelecido em metadados e esse valor é retornado.A dependency property has a default value established in metadata and that value is returned. Esse valor pode vir de DefaultMetadata.This value might come from DefaultMetadata.

  • Algum outro valor foi estabelecido pelo sistema de propriedades, e o valor padrão não é mais relevante.Some other value was established by the property system, and the default value is no longer relevant. Para obter mais detalhes, consulte Precedência do valor da propriedade da dependência.For details, see Dependency Property Value Precedence.

A definição de uma DefaultValue de UnsetValue não é permitida especificamente.Setting a DefaultValue of UnsetValue is specifically disallowed.

DependencyObject.ReadLocalValue retorna UnsetValue quando a propriedade solicitada não foi definida localmente.DependencyObject.ReadLocalValue returns UnsetValue when the requested property has not been locally set.

UnsetValue tem um significado especial quando usado como o valor de retorno de um CoerceValueCallback.UnsetValue has a special meaning when used as the return value of a CoerceValueCallback. Para obter detalhes, consulte retornos de chamada de propriedade de dependência e validação.For details, see Dependency Property Callbacks and Validation.

Se você estiver ligando a um banco de dados, observe que UnsetValue não é equivalente a Value, de forma semelhante a como Value não é equivalente a um verdadeiro 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.

Aplica-se a