DependencyProperty.UnsetValue Campo
Definição
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
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.