FrameworkPropertyMetadata.IsNotDataBindable Propriedade
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.
Obtém ou define um valor que indica se o valor da propriedade de dependência é compatível com a associaçã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 da propriedade
true se a propriedade não oferecer suporte à associação de dados; caso contrário, false. O padrão é false.
Exceções
Os metadados já foram aplicados à operação de propriedade de dependência, portanto os metadados estão selados e as propriedades dos metadados não podem ser definidas.
Comentários
Observe que essa propriedade de metadados está definida especificamente para propriedades que não devem dar suporte à true associação de dados, apesar de serem propriedades de leitura/gravação. A expectativa é que, na maioria dos casos em que uma propriedade de dependência é declarada, a associação de dados é desejada, pois a associação de dados é um dos principais cenários em que uma propriedade de dependência é útil. Ao contrário BindsTwoWayByDefault, isso não apenas altera um padrão que pode ser alterado posteriormente em uma associação específica. Definir essa propriedade true nos metadados de um metadados de propriedade de dependência desabilitará todas as associações de aplicar seus valores por meio de expressões a essa propriedade de dependência.
As propriedades de dependência somente leitura não dão suporte à associação de dados (porque não têm nenhum setter que possa aplicar valores alterados), mas ainda serão reportadasfalse.IsNotDataBindable Isso ocorre porque as propriedades que correspondem a um FrameworkPropertyMetadataOptions valor relatarão a paridade com a forma como os metadados foram realmente estabelecidos, em vez de sempre relatarem o comportamento de resultado final que a nomenclatura da propriedade pode implicar. Para determinar se uma determinada propriedade de dependência permite a associação de dados, você geralmente deve fazer check-in IsDataBindingAllowed . IsDataBindingAllowed é uma conveniência para verificar ambos ReadOnly e IsNotDataBindable como uma única operação, gerando o resultado esperado.
As propriedades em classes derivadas são PropertyMetadata normalmente definidas no modelo de objeto como leitura-gravação. Isso é para que eles possam ser ajustados após a inicialização da instância. No entanto, depois que os metadados forem consumidos como parte de uma chamada para Register, AddOwnerou OverrideMetadata, o sistema de propriedades selará essa instância de metadados e as propriedades que transmitem as especificidades dos metadados agora são consideradas imutáveis. A tentativa de definir essa propriedade depois IsSealed de estar true nessa instância de metadados gerará uma exceção.
Uso de texto XAML
Os membros dessa classe normalmente não são usados no XAML.