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:
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 CLRdeclaringType: o tipo da classe que declara a propriedadedefaultValue: 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álidopropertyChanging: um retorno de chamada para indicar quando a propriedade está prestes a ser alteradacoerceValue: um retorno de chamada para forçar um valor definido para outro valordefaultValueCreate: 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 .