Compartilhar via


DependencyProperty.UnsetValue Campo

Definição

Especifica um valor estático que é usado pelo sistema de propriedades WPF em vez de null indicar que a propriedade existe, mas não tem seu valor definido pelo sistema de propriedades.

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 sentinela usado para cenários em que o sistema de propriedades do WPF não consegue determinar um valor solicitado DependencyProperty . UnsetValueé usado em vez de null, porque null pode ser um valor de propriedade válido, bem como um válido (e usado com frequência). DefaultValue

UnsetValue nunca é retornado de DependencyObject.GetValue. Quando você chama DependencyObject.GetValue em uma propriedade de dependência em uma DependencyObject instância, uma das seguintes aplica-se:

  • Uma propriedade de dependência tem um valor padrão estabelecido em metadados e esse valor é retornado. Esse valor pode vir de DefaultMetadata.

  • Algum outro valor foi estabelecido pelo sistema de propriedades e o valor padrão não é mais relevante. Para obter mais detalhes, consulte Precedência do valor da propriedade da dependência.

Definir um DefaultValue de UnsetValue é especificamente não permitido.

DependencyObject.ReadLocalValue retorna UnsetValue quando a propriedade solicitada não foi definida localmente.

UnsetValue tem um significado especial quando usado como o valor retornado de um CoerceValueCallback. Para obter detalhes, consulte Retornos de chamada e validação da propriedade de dependência.

Se você estiver associando a um banco de dados, observe que UnsetValue não é equivalente a Value, de maneira semelhante a como Value não é equivalente a um verdadeiro nulo.

Aplica-se a