Partilhar via

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

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 de C# está familiarizado com as propriedades de C#. As propriedades contêm um acessador set 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 aprimorada chamada propriedade associável encapsulada BindableProperty pela classe e suportada BindableObject pela classe. Essas classes são relacionadas, mas bastante distintas: A BindableProperty é usada 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 reflexão para exibir uma hierarquia de classe e demonstrar a função crucial desempenhada 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 classes

Uma espiada em BindableObject e BindableProperty

Nas classes que derivam de BindableObject muitas propriedades CLR, diz-se que são "apoiadas por" propriedades associáveis. Por exemplo, a Text Label propriedade da classe é uma propriedade CLR, mas a Label classe também define um campo público estático somente leitura 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 é totalmente implementada usando os SetValue métodos and GetValue definidos por BindableObject em conjunto com a Label.TextProperty propriedade static.

BindableObject e BindableProperty fornecer suporte para:

  • Dando 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
  • Acionar notificações quando uma propriedade está prestes a ser alterada ou foi alterada
  • Suporte à associação de dados
  • Estilos de suporte
  • Suporte a recursos dinâmicos

Sempre que uma propriedade que é apoiada por uma propriedade associável é alterada, BindableObject o aciona um PropertyChanged evento que identifica 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 associáveis e algumas Xamarin.Forms classes — como Span — não derivam de BindableObject. Somente uma classe derivada de BindableObject pode dar suporte a propriedades associáveis porque BindableObject define os SetValue métodos e GetValue .

Como Span não deriva de BindableObject, nenhuma de suas propriedades — como Text — é apoiada 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 pelo 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 static 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 e permite especificar um tamanho de Label fonte em pontos. Ele é demonstrado no exemplo PointSizedText.

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

  • propertyName: o nome do 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 for returnType double, deverá defaultValue 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 muda de 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: usado em conexão com a vinculação de dados (conforme discutido no Capítulo 16. Vinculação de dados)
  • validateValue: um retorno de chamada para verificar se há um valor válido
  • propertyChanging: um retorno de chamada para indicar quando a propriedade está prestes a ser alterada
  • coerceValue: um retorno de chamada para forçar 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 associável somente leitura

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

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

Isso é demonstrado na CountedLabel classe usada no exemplo BaskervillesCount .

  • Last updated on