Usando o exemplo Monitor de Assinante
A solução Exemplo pedido de vendas inclui dois projetos adicionais, SubscriberMonitor e SubscriberMonitorUtility. Juntos, esses projetos usam o suporte do monitor de replicação em RMO (Replication Management Objects) para fornecer a funcionalidade para monitorar o status da assinatura no Assinante local. O assembly SubscriberMonitor.dll fica acessível através de outros aplicativos que executam o Assinante e o programa SubscriberMonitorUtility.exe é executado diretamente para exibir o Monitor de Assinante.
Usando Monitor de Assinante
Para construir e executar o exemplo do utilitário Monitor de Assinante
Verifique se os exemplos de replicação do SQL Server estão instalados. Para obter mais informações, consulte Considerações para instalar exemplos e bancos de dados de exemplo do SQL Server.
Navegue até o local de instalação para o exemplo Monitor de Assinante. O local padrão para este exemplo é C:\Arquivos de Programas\Microsoft SQL Server\100\Samples\Replication\Merge\CS\SubscriberMonitorUtility.
Abra o arquivo de solução SubscriberMonitorUtility.sln em Visual Studio.
Construa a solução.
Execute SubscriberMonitorUtility.exe do local de compilação. O local de compilação padrão é \bin\debug.
Na caixa de diálogo Selecionar Assinatura para Monitorar escolha uma instância de SQL Server da caixa suspensa Nome do Servidor Local.
Selecione uma assinatura para monitorar na caixa de listagem suspensa Assinaturas Disponíveis.
(Opcional) Clique no botão Editar para alterar propriedades de assinatura.
Clique em Conectar.
Selecione uma sessão do Merge Agent da exibição de árvore Mesclar Sessões.
(Opcional) Clique no botão Atualizar para atualizar a lista de sessão.
Para invocar o Monitor de Assinante programaticamente
Abra o projeto Visual Studio que invocará o Monitor de Assinante.
Adicione uma referência ao assembly SubscriberMonitor.dll. Esse assembly é criado como parte das soluções do SubscriberMonitorUtility.sln ou SalesOrders.sln. Para obter mais informações sobre como construir exemplo para os pedidos de vendas, consulte Exemplo de replicação de mesclagem dos pedidos Readme_Sales.
(Opcional) Adicione uma diretiva using (C#) ou instrução Imports (Visual Basic .NET) para o Microsoft.Samples.SqlServer namespace.
Em seu código, crie uma instância da classe SubscriberMonitor em um dos seguintes modos:
- Passando o nome de Assinante e um objeto SubscriberSubscription que representam a assinatura para monitorar ao parâmetro subscription.
- Passando valores ao construtor para os seguintes parâmetros que definem a assinatura subscriber, publication, publisher, publicationDb, subscriber e subscriptionDb.
Detalhes de implementação
O Monitor de Assinante é um aplicativo de formato Windows com base em Microsoft Windows .NET Framework 2.0. O aplicativo é iniciado ao executar SubscriberMonitorUtility.exe. Esse executável cria uma instância da classe SubscriberMonitor, exibe um diálogo que habilita o usuário a selecionar a assinatura para o monitor e, então, exibe o formato Windows. A classe SubscriberMonitor também pode ser instanciada de um aplicativo de exemplo. Dois métodos de construtor são implementados o que lhe permite passar propriedades de assinatura durante a criação do objeto novo. Essas propriedades também podem ser definidas depois que o objeto for criado.
Quando o construtor padrão é usado, uma caixa de diálogo é exibida o que lhe permite selecionar a instância do Assinante no computador local como também a assinatura para monitorar. A caixa de listagem suspensa Nome do Servidor Local é populada com nomes de instância disponíveis retornados pela propriedade ServerInstances. Quando uma instância do servidor é selecionada, a caixa de listagem suspensa Assinaturas Disponíveis é populada com assinaturas retornadas pelo método EnumSubscriberSubscriptions.
O exemplo usa a classe MergeSubscriberMonitor para recuperar informações de assinatura do Assinante e exibir essas informações no formulário. Quando o formulário carrega, o método GetSessionsSummary retorna uma matriz de objetos MergeSessionSummary que representam até cinco sessões anteriores do Merge Agent. O controle Mesclar Sessões TreeView é populado com os objetos MergeSessionSummary. Quando você seleciona uma das sessões, são exibidas informações de resumo sobre a sessão. Também, a matriz de objetos MergeSessionDetail retornada pelo método GetSessionDetails é exibida no controle Artigos processados na sessão ListView.
Para obter mais informações sobre como programar com a classe MergeSubscriberMonitor, consulte Como monitorar programaticamente a replicação (programação RMO).