Compartilhar via

Resumo do Capítulo 11. A infraestrutura vinculável

  • Artigo

Observação

Este livro foi publicado na primavera de 2016, e não foi atualizado desde então. Há muito no livro que permanece valioso, mas parte do material está desatualizado, e alguns tópicos não estão mais totalmente corretos ou completos.

Todo programador C# está familiarizado com as propriedades do C#. As propriedades contêm um acessador definido e/ou um acessador get . Eles geralmente são chamados de propriedades CLR para o Common Language Runtime.

Xamarin.Forms Define uma definição de propriedade avançada chamada uma propriedade vinculável encapsulada BindableProperty pela classe e suportada BindableObject pela classe. Essas classes são relacionadas, mas bastante distintas: O BindableProperty é usado para definir a propriedade em si, BindableObject é como object se fosse uma classe base para classes que definem propriedades vinculáveis.

A Xamarin.Forms hierarquia de classes

O exemplo ClassHierarchy usa a reflexão para exibir uma hierarquia de classes e demonstrar o papel crucial desempenhado Xamarin.Forms por BindableObject essa hierarquia. BindableObject deriva de Object e é a classe pai da Element qual VisualElement deriva. Esta é a classe pai para Page e View, que é a classe pai para Layout:

Captura de tela tripla do compartilhamento de hierarquia de classe

Uma espiada em BindableObject e BindableProperty

Nas classes que derivam de BindableObject muitas propriedades CLR são ditas como "apoiadas por" propriedades vinculáveis. Por exemplo, a TextLabel propriedade da classe é uma propriedade CLR, mas a Label classe também define um campo somente leitura estático público chamado TextProperty do tipo BindableProperty.

Um aplicativo pode definir ou obter a Text propriedade de Label normalmente, ou o aplicativo pode definir o Text chamando o SetValue método definido por BindableObject com um Label.TextProperty argumento. Da mesma forma, um aplicativo pode obter o valor da Text propriedade chamando o GetValue método, novamente com um Label.TextProperty argumento. Isso é demonstrado pelo exemplo PropertySettings .

De fato, a Text propriedade CLR é inteiramente implementada usando os SetValue métodos e GetValue definidos por BindableObject em conjunto com a Label.TextProperty propriedade estática.

BindableObject e BindableProperty fornecer suporte para:

  • Fornecendo valores padrão às propriedades
  • Armazenando seus valores atuais
  • Fornecendo mecanismos para validar valores de propriedade
  • Mantendo a consistência entre propriedades relacionadas em uma única classe
  • Respondendo a alterações de propriedade
  • Disparando notificações quando uma propriedade está prestes a ser alterada ou foi alterada
  • Suporte à vinculação de dados
  • Estilos de suporte
  • Suporte a recursos dinâmicos

Sempre que uma propriedade que é apoiada por uma propriedade vinculável é alterada, BindableObject dispara um PropertyChanged evento identificando a propriedade que foi alterada. Esse evento não é acionado quando a propriedade é definida com o mesmo valor.

Algumas propriedades não são apoiadas por propriedades vinculáveis, e algumas Xamarin.Forms classes — como Span — não derivam de BindableObject. Somente uma classe derivada de BindableObject pode oferecer suporte a propriedades vinculáveis porque BindableObject define os SetValue métodos e GetValue .

Porque Span não deriva de BindableObject, nenhuma de suas propriedades — como Text — é lastreada por uma propriedade vinculável. É por isso que uma DynamicResource configuração na Text propriedade de Span gera uma exceção no exemplo DynamicVsStatic no capítulo anterior. O exemplo DynamicVsStaticCode demonstra como definir recursos dinâmicos no código usando o SetDynamicResource método definido por Element. O primeiro argumento é um objeto do tipo BindableProperty.

Da mesma forma, o SetBinding método definido por BindableObject tem um primeiro argumento do tipo BindableProperty.

Definindo propriedades vinculáveis

Você pode definir suas próprias propriedades vinculáveis usando o método estático BindableProperty.Create para criar um campo estático somente leitura do tipo BindableProperty.

Isso é demonstrado na AltLabel classe na Xamarin.Formsbiblioteca Book.Toolkit. A classe deriva de Label e permite especificar um tamanho de fonte em pontos. Isso é demonstrado no exemplo PointSizedText.

Quatro argumentos do BindableProperty.Create método são necessários:

  • propertyName: o nome de texto da propriedade (o mesmo que o nome da propriedade CLR)
  • returnType: o tipo da propriedade CLR
  • declaringType: o tipo da classe que declara a propriedade
  • defaultValue: o valor padrão da propriedade

Como defaultValue é do tipo object, o compilador deve ser capaz de determinar o tipo do valor padrão. Por exemplo, se o returnType é double, o defaultValue deve ser definido como algo como 0.0 em vez de apenas 0, ou a incompatibilidade de tipo acionará uma exceção em tempo de execução.

Também é muito comum que uma propriedade vinculável inclua:

  • propertyChanged: um método estático chamado quando a propriedade altera o valor. O primeiro argumento é a instância da classe cuja propriedade foi alterada.

Os outros argumentos não BindableProperty.Create são tão comuns:

  • defaultBindingMode: utilizado em ligação com a ligação de dados (conforme discutido no capítulo 16. Vinculação de dados)
  • validateValue: um retorno de chamada para verificar um valor válido
  • propertyChanging: um retorno de chamada para indicar quando a propriedade está prestes a mudar
  • coerceValue: um retorno de chamada para coagir um valor definido para outro valor
  • defaultValueCreate: um retorno de chamada para criar um valor padrão que não pode ser compartilhado entre instâncias da classe (por exemplo, uma coleção)

A propriedade vinculável somente leitura

Uma propriedade vinculável pode ser somente leitura. A criação de uma propriedade vinculável somente leitura requer chamar o método BindableProperty.CreateReadOnly estático para definir um campo estático somente leitura privado do tipo BindablePropertyKey.

Em seguida, defina o acessador da propriedade set CLR como private para chamar uma SetValue sobrecarga com o BindablePropertyKey objeto. Isso impede que a propriedade seja definida fora da classe.

Isso é demonstrado na CountedLabel classe usada na amostra BaskervillesCount .