Depurar um manipulador de lógica de negócios (programação de replicação)

Utilize um manipulador de lógica de negócios para invocar a lógica de negócios personalizada quando uma assinatura de fusão for sincronizada. Para obter mais informações, consulte Executar lógica de negócios durante a sincronização de mesclagem.

O Merge Replication Reconciler (replrec.dll) chama o assembly de código gerenciado que contém a lógica de negócios. Na maioria das vezes, replrec.dll e a lógica de negócios personalizada são executadas no computador em que o Merge Agent é executado (no Assinante para uma assinatura pull ou no Distribuidor para uma assinatura push). No caso da sincronização via Web ou de um Assinante do SQL Server Compact, o reconciliador e a lógica de negócios personalizada são executados no servidor Web.

Para depurar um manipulador de lógica de negócios em um computador local

1. Configure a publicação e a distribuição, crie uma publicação e crie uma assinatura para a publicação. Para obter mais informações, consulte Configurar Publicação e Distribuição e Criar uma Publicação.

2. Crie e registre um manipulador de lógica de negócios. Para obter mais informações, consulte Implementar um manipulador de lógica de negócios para um artigo de mesclagem.

3. Crie um projeto RMO (Replication Management Objects) no Microsoft Visual Studio que inicia programaticamente o Merge Agent de forma síncrona. Para obter mais informações, consulte Synchronize a Pull Subscription.

4. Defina um ponto de interrupção no código do manipulador de lógica de negócios, seja no método que está sendo depurado ou no construtor de classe. Para obter mais informações sobre os métodos que podem ser implementados em um manipulador de lógica de negócios, consulte o tópico de BusinessLogicModule métodos.

5. Construa o manipulador de lógica de negócios no modo de depuração e implante o assembly e o arquivo de símbolo de depuração (.pdb) no local registrado na etapa 1.

   Observação

   Para simplificar a depuração, crie uma única solução do Visual Studio .NET que contenha tanto o projeto do manipulador de lógica de negócios quanto o projeto que sincroniza a assinatura. Nesse caso, defina o projeto de sincronização como o projeto de inicialização e configure o ambiente de compilação para implantar o assembly de lógica de negócios no local registrado na etapa 1 durante a depuração.

6. Execute comandos de inserção, atualização ou exclusão no banco de dados de assinatura ou publicação. O comando e o local de execução dependem do método que está sendo depurado.

7. Inicie o projeto a partir da etapa 3 no modo de debug para sincronizar a assinatura.

8. Supondo que nenhum outro ponto de interrupção esteja definido e os comandos adequados sejam replicados, a execução será interrompida quando atingir o ponto de interrupção no manipulador de lógica de negócios.

Para depurar um manipulador de lógica de negócios em um servidor Web usando a sincronização da Web ou para um Assinante do SQL Server Compact

1. Configure a publicação e a distribuição, crie uma publicação e crie uma assinatura pull para a publicação. A publicação deve dar suporte à sincronização da Web ou aos Assinantes compactos do SQL Server.

2. Crie e registre um manipulador de lógica de negócios. Para obter mais informações, consulte Implementar um manipulador de lógica de negócios para um artigo de mesclagem.

3. Defina um ponto de interrupção no código do manipulador de lógica de negócios, seja no método que está sendo depurado ou no construtor de classe. Para obter mais informações sobre os métodos que podem ser implementados em um manipulador de lógica de negócios, consulte o tópico de BusinessLogicModule métodos.

4. Crie o manipulador de lógica de negócios no modo de depuração e implante o arquivo de assembly e o arquivo de símbolo de depuração (.pdb) no local registrado na etapa 1 no servidor Web.

   Observação

   Se o manipulador de lógica de negócios não for criado porque o assembly está em uso, digite o comando iisreset no prompt de comando do servidor Web para redefinir o servidor Web.

5. Sincronize a assinatura com a sincronização da Web habilitada. Durante a sincronização, o servidor Web carrega a assembly registrada.

6. Usando o depurador .NET do Visual Studio, anexe-se a um dos seguintes processos no servidor Web:

   • w3wp.exe – Windows Server 2003.

   • inetinfo.exe – Windows 2000 e Windows XP.

7. Na janela Saída, verifique a saída de depuração para confirmar se os símbolos do assembly registrado foram carregados corretamente. Se os símbolos não foram carregados, verifique se o arquivo .pdb correto foi copiado na etapa 4 e repita a etapa 5.

8. Execute comandos de inserção, atualização ou exclusão no banco de dados de assinatura ou publicação. O comando e o local de execução dependem do método que está sendo depurado.

9. Usando o depurador do Visual Studio, anexe-se ao processo de w3wp.exe.

10. Sincronize a assinatura novamente usando a sincronização da Web.

11. Supondo que nenhum outro ponto de interrupção esteja definido e os comandos adequados sejam replicados, a execução será interrompida quando atingir o ponto de interrupção no manipulador de lógica de negócios.

Consulte Também

Implementar um Manipulador de Lógica de Negócios para um Artigo de Mesclagem