FrameworkPropertyMetadata.IsNotDataBindable Propriedade
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.
Recebe ou define um valor que indica se a propriedade de dependência suporta ligação de dados.
public:
property bool IsNotDataBindable { bool get(); void set(bool value); };public bool IsNotDataBindable { get; set; }member this.IsNotDataBindable : bool with get, setPublic Property IsNotDataBindable As BooleanValor de Propriedade
true se a propriedade não suportar ligação de dados; caso contrário, false. A predefinição é false.
Exceções
Os metadados já foram aplicados a uma operação de propriedade de dependência, pelo que os metadados ficam selados e as propriedades dos metadados não podem ser definidas.
Observações
Note que esta propriedade de metadados está definida especificamente true para propriedades que não devem suportar ligação de dados, apesar de serem propriedades de leitura-escrita. A expectativa é que, na maioria dos casos em que uma propriedade de dependência é declarada, a ligação de dados seja desejável, porque a ligação de dados é um dos cenários-chave em que uma propriedade de dependência é útil. Ao contrário de BindsTwoWayByDefault, isto não altera apenas um padrão que pode ser alterado posteriormente numa ligação específica. Definir esta propriedade true nos metadados de uma propriedade de dependência irá desabilitar todas as ligações de aplicar os seus valores através de expressões a essa propriedade de dependência.
As propriedades de dependência apenas de leitura não suportam ligação de dados (porque não têm um setter que possa aplicar valores alterados), mas continuam a reportar false para IsNotDataBindable. Isto porque propriedades que correspondem a valores FrameworkPropertyMetadataOptions reportam paridade com a forma como os metadados foram realmente estabelecidos, em vez de sempre reportarem o comportamento final que a nomeação da propriedade possa implicar. Para determinar se uma dada propriedade de dependência permite a ligação de dados, normalmente deve verificar IsDataBindingAllowed .
IsDataBindingAllowed é uma conveniência para verificar ambos ReadOnly e IsNotDataBindable como uma única operação, produzindo o resultado esperado.
As propriedades nas classes derivadas de PropertyMetadata são tipicamente definidas no modelo de objetos como leitura-escrita. Isto serve para que possam ser ajustados após a inicialização da instância. No entanto, depois de os metadados serem consumidos como parte de uma chamada a Register, AddOwner, ou OverrideMetadata, o sistema de propriedades selará essa instância de metadados e as propriedades que transmitem as especificidades dos metadados são agora consideradas imutáveis. Tentar definir esta propriedade depois IsSealed de estar true nesta instância de metadados irá gerar uma exceção.
Utilização de Texto XAML
Os membros desta classe normalmente não são usados em XAML.