DependencyProperty.UnsetValue Campo
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.
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 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: