Como trabalhar com perfis de agente de replicação (programação RMO)

Crie uma conexão para o Distribuidor usando uma instância da classe ServerConnection.

Crie uma instância da classe AgentProfile.

Defina as seguintes propriedades no objeto:

• Name - o nome para o perfil.

• AgentType- um valor AgentType que especifica o tipo de agente de replicação para o qual está sendo criado o perfil.

• ConnectionContext - o ServerConnection criado na etapa 1.

• (Opcional) Description- uma descrição do perfil.

• (Opcional) Default - defina essa propriedade para true se todos os trabalhos de agente novos para essa AgentType utilizarão, por padrão, esse perfil.

Chame o método Create para criar o perfil no servidor.

Uma vez que o perfil existir no servidor, você poderá personalizá-lo adicionando, removendo ou modificando os valores dos parâmetros do agente de replicação.

Para atribuir o perfil a um trabalho de agente de replicação existente, chame o método AssignToAgent. Passe o nome do banco de dados de distribuição para distributionDBName e a ID do trabalho para agentID.

Crie uma conexão para o Distribuidor usando uma instância da classe ServerConnection.

Crie uma instância da classe ReplicationServer. Passe o objeto ServerConnection criado na etapa 1.

Chame o método LoadProperties. Se esse método retornar false, verifique se o Distribuidor existe.

Chame o método EnumAgentProfiles. Passe um valor AgentType para reduzir os perfis retornados a um tipo específico de agente de replicação.

Obtenha o objeto desejado AgentProfile dos ArrayList retornados, nos quais a propriedade Name do objeto corresponda ao nome do perfil.

Chame um dos métodos seguintes de AgentProfile para alterar o perfil:

• AddParameter - adiciona um parâmetro com suporte ao perfil, onde name é o nome parâmetro do agente de replicação e value é o valor especificado. Para enumerar todos os parâmetros de agente com suporte para um determinado tipo de agente, chame o método EnumParameterInfo. Este método retorna um ArrayList de objetos AgentProfileParameterInfo que representam todos os parâmetros com suporte.

• RemoveParameter- remove um parâmetro existente do perfil, onde name é o nome do parâmetro do agente de replicação. Para enumerar todos os parâmetros de agente atuais definidos para o perfil, chame o método EnumParameters. Este método retorna um ArrayList de objetos AgentProfileParameter que representam o parâmetro existente para este perfil.

• ChangeParameter - altera a configuração de um parâmetro existente no perfil, onde name é o nome do parâmetro do agente de replicação e newValue é o valor para o qual o parâmetro está sendo alterado. Para enumerar todos os parâmetros de agente atuais definidos para o perfil, chame o método EnumParameters. Este método retorna um ArrayList de objetos AgentProfileParameter que representam o parâmetro existente para este perfil. Para enumerar todas as configurações de parâmetro de agente com suporte, chame o método EnumParameterInfo. Este método retorna um ArrayList de objetos AgentProfileParameterInfo que representam os valores com suporte para todos os parâmetros.

Crie uma conexão para o Distribuidor usando uma instância da classe ServerConnection.

Crie uma instância da classe AgentProfile. Defina o nome do perfil para Name e o ServerConnection da etapa 1 para ConnectionContext.

Chame o método LoadProperties. Se este método retornar false, o banco de dados com o nome especificado estava incorreto ou o perfil não existe no servidor.

Verifique se a propriedade Type é definida como User, o que indica um perfil de cliente. Você não deve remover um perfil que possui um valor de System para Type.

Chame o método Remove para remover o perfil definido pelo usuário representado por esse objeto do servidor.