Ler em inglês

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.

C#
public static readonly object UnsetValue;

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

Produto Versões
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10