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

  • Artigo

Baixar exemplo Baixar o exemplo

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 concluídos.

Cada programador C# está familiarizado com as propriedades do C#. As propriedades contêm um acessador definido e/ou um acessador get . Geralmente, elas são chamadas de propriedades CLR para o Common Language Runtime.

Xamarin.Forms define uma definição de propriedade aprimorada chamada uma propriedade associável encapsulada pela BindableProperty classe e compatível com a BindableObject 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 associáveis.

A Xamarin.Forms hierarquia de classe

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

de tela tripla de compartilhamento de hierarquia de classe de compartilhamento de hierarquia de classe

Uma espiada em BindableObject e BindableProperty

Nas classes derivadas de BindableObject muitas propriedades CLR são consideradas "apoiadas por" propriedades associáveis. Por exemplo, a Text propriedade da Label classe é uma propriedade CLR, mas a Label classe também define um campo público somente leitura estático 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 e GetValue definidos por BindableObject em conjunto com a Label.TextProperty propriedade estática.

BindableObject e BindableProperty forneça suporte para:

  • Fornecer valores padrão de propriedades
  • Armazenando seus valores atuais
  • Fornecendo mecanismos para validar valores de propriedade
  • Mantendo a consistência entre as propriedades relacionadas em uma única classe
  • Respondendo a alterações de propriedade
  • Disparando notificações quando uma propriedade está prestes a ser alterada ou 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 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 associá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 associáveis

Você pode definir suas próprias propriedades associá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 que você especifique um tamanho de fonte em pontos. Ela é demonstrada 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 declarando 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 returnTypedouble, o defaultValue deverá ser definido como algo como 0,0 em vez de apenas 0 ou a incompatibilidade de tipo disparará uma exceção em runtime.

Também é muito comum que uma propriedade associá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 a não BindableProperty.Create são tão comuns:

  • defaultBindingMode: usado em conexão com a associação de dados (conforme discutido no Capítulo 16. Associação de dados)
  • validateValue: um retorno de chamada para marcar para 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 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 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 estático para definir um campo somente leitura estático privado do tipo BindablePropertyKey.

Em seguida, defina o accesor de 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 no exemplo BaskervillesCount .