Histórico da Página

A classe MessagingCenter implementa o padrão Publish-Subscribe, permitindo a comunicação baseada em mensagens entre componentes com baixo acoplamento. Esse mecanismo permite que publicadores e assinantes se comuniquem sem ter uma referência direta um ao outro, ajudando a reduzir as dependências entre os componentes, além de permitir que os componentes sejam desenvolvidos e testados de forma independente.

Aclasse MessagingCenter fornece a funcionalidade de publicação/assinatura multicast. Isso significa que pode haver vários publicadores que publicam uma única mensagem e vários assinantes ouvindo a mesma mensagem. A imagem abaixo ilustra essa relação:

Os publicadores enviam mensagens usando ométodo MessagingCenter.Send, enquanto os assinantes escutam as mensagens usando ométodo MessagingCenter.Subscribe. Além disso, os assinantes também podem cancelar assinaturas de mensagens, se necessário, com ométodo MessagingCenter.Unsubscribe.

Internamente, aclasse MessagingCenter usa referências fracas. Isso significa que ele não manterá os objetos "vivos" e permitirá que eles sejam coletados como lixo. Portanto, só deve ser necessário cancelar a assinatura de uma mensagem quando uma classe não deseja mais recebe-la. 

Os publicadores notificam os assinantes de uma mensagem com uma dassobrecargas MessagingCenter.Send. O exemplo de código a seguir demonstra a publicação damensagem LoginShowPass:

	MessagingCenter.Send(this, MessageKeys.LoginShowPass);

Clique para acessar o arquivo

Neste exemplo, o método Send especifica dois argumentos:

• O primeiro argumento especifica a classe do remetente. Ela deve ser especificada por qualquer assinante que deseje receber a mensagem.
• O segundo argumento especifica a mensagem.

Se necessário, um terceiro argumento pode especificar os dados de payload a serem enviados ao assinante. Esse payload pode ser de qualquertipo object. Será importante que o assinante da mensagem conheça o tipo de payload esperado.

O método Send publicará a mensagem e seus dados usando uma abordagem de fire-and-forget. Portanto, a mensagem é enviada mesmo que não haja assinantes cadastrados para receber a mensagem. Nessa situação, a mensagem enviada é ignorada.

Os assinantes podem se registrar para receber uma mensagem usando uma das sobrecargas. O exemplo de código a seguir demonstra como o aplicativo MinhaQualidadeMaui se inscreve e processa a mensagem LoginShowPass:

MessagingCenter.Subscribe<RMSLoginViewModel>(this, MessageKeys.LoginShowPass, (viewModel) =>
{
  Dispatcher.Dispatch(() =>
  {
    ImageShowSenha.Source = entrySenha.IsPassword ? "ImageShowSenhaOn.png" : "ImageShowSenhaOff.png";
    entrySenha.IsPassword = !entrySenha.IsPassword;
  });
});

Clique para acessar o arquivo

No exemplo anterior, o método Subscribe assina a mensagem LoginShowPass e executa um delegate de retorno de chamada em resposta ao recebimento da mensagem. Esse delegate de retorno de chamada, especificado como uma expressão lambda, executa o código que atualiza a interface do usuário.

Os assinantes podem cancelar a assinatura de mensagens que não desejam mais receber. Isso é obtido com uma dassobrecargas MessagingCenter.Unsubscribe, conforme demonstrado no exemplo de código a seguir:

MessagingCenter.Unsubscribe<RMSLoginViewModel>(this, MessageKeys.LoginShowPass);

Clique para acessar o arquivo

Neste exemplo, a sintaxe do método Unsubscribe reflete os argumentos de tipo especificados ao se inscrever para receber a mensagem LoginShowPass.