DependencyProperty.UnsetValue Campo
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Especifica um valor estático que é usado pelo sistema de propriedades WPF em vez de null para indicar que a propriedade existe, mas não tem o seu valor definido pelo sistema de propriedades.
public: static initonly System::Object ^ UnsetValue;public static readonly object UnsetValue; staticval mutable UnsetValue : objPublic Shared ReadOnly UnsetValue As Object Valor de Campo
Observações
UnsetValue é um valor sentinela usado em cenários em que o sistema de propriedades WPF não consegue determinar um valor DependencyProperty solicitado.
UnsetValue é usado em vez de null, porque null poderia ser um valor de propriedade válido, bem como um válido (e frequentemente usado) DefaultValue.
UnsetValue nunca é devolvido a partir de DependencyObject.GetValue. Quando invoca DependencyObject.GetValue uma propriedade de dependência numa DependencyObject instância, aplica-se uma das seguintes opções:
Uma propriedade de dependência tem um valor padrão estabelecido nos metadados e esse valor é devolvido. Este valor pode vir de DefaultMetadata.
Algum outro valor foi estabelecido pelo sistema de propriedades, e o valor padrão deixou de ser relevante. Para obter informações detalhadas, consulte Dependency Property Value Precedence.
Definir um DefaultValue de UnsetValue é especificamente proibido.
DependencyObject.ReadLocalValue retorna UnsetValue quando a propriedade solicitada não foi definida localmente.
UnsetValue tem um significado especial quando usado como valor de retorno de um CoerceValueCallback. Para detalhes, veja Retornos de Propriedades de Dependência e Validação.
Se estiver a ligar a uma base de dados, note que UnsetValue não é equivalente a Value, de forma semelhante a como Value não é equivalente a um verdadeiro nulo.