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

Aplica-se a:SQL Server

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

O Reconciliador de replicação de mesclagem (replrec.dll) chama o assembly de código gerenciado que contém a lógica comercial. Na maior parte dos casos, o replrec.dll e a lógica comercial personalizada são executados no computador em que o Agente de Mesclagem é executado (no Assinante para a assinatura pull ou no Distribuidor da assinatura push). No caso da sincronização da Web ou no caso de um Assinante do SQL Server Compact, o reconciliador e a lógica comercial personalizada são executados no servidor da 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, confira 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 iniciará o Agente de Mesclagem em sincronia, programaticamente. 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, tanto no método sendo depurado como no construtor da classe. Para obter mais informações sobre os métodos que podem ser implementados no manipulador de lógica de negócios, consulte o tópico dos métodos BusinessLogicModule .

5. Crie 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 solução única de Visual Studio .NET que contenha ambos o projeto do manipulador de lógica de negócios e o projeto que sincroniza a assinatura. Nesse caso, defina o projeto de sincronização como projeto de inicialização e configure o ambiente de compilação para implantar o assembly da lógica comercial no local registrado na Etapa 1, durante a depuração.

6. Execute a inserção, atualize ou exclua comandos de acordo com a assinatura ou banco de dados de publicação. O comando e o local da execução dependem do método que é depurado.

7. Inicie o projeto na Etapa 3, em modo de depuração, para sincronizar a assinatura.

8. Supondo que nenhum outro ponto de interrupção esteja definido e que os comandos tenham sido replicados, a execução para quando alcança o ponto de interrupção do 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 ser compatível com a sincronização da Web ou com os assinantes do SQL Server Compact.

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, tanto no método sendo depurado como no construtor da classe. Para obter mais informações sobre os métodos que podem ser implementados no manipulador de lógica de negócios, consulte o tópico dos métodos BusinessLogicModule .

4. Crie 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

   Se o manipulador de lógica de negócios falhar em criar por causa do assembly que está em uso, digite o comando iisreset no servidor Web, no prompt de comando do servidor Web.

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

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

   • w3wp.exe - Windows Server 2003.

   • inetinfo.exe - Windows 2000 e Windows XP.

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

8. Execute a inserção, atualize ou exclua comandos de acordo com a assinatura ou banco de dados de publicação. O comando e o local da execução dependem do método que é depurado.

9. Usando o depurador do Visual Studio, anexe ao processo 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 que os comandos tenham sido replicados, a execução para quando alcança o ponto de interrupção do manipulador de lógica de negócios.

Confira também

Implementar um manipulador de lógica de negócios para um artigo de mesclagem