Compartilhar via


Método Merge.Merge

O método Merge do objeto Merge executa uma mesclagem do banco de dados atual e do módulo atual. A mesclagem anexa os componentes no módulo ao recurso identificado por Feature. A raiz da árvore de diretório do módulo é redirecionada para o local fornecido por RedirectDir.

O método Merge só pode ser chamado uma vez para mesclar uma combinação específica de arquivos .msi e .msm.

Sintaxe

Merge.Merge(
  Feature,
  RedirectDir
)

Parâmetros

Recurso

O nome de um recurso no banco de dados.

RedirectDir

A chave de uma entrada na tabela Directory do banco de dados. Esse parâmetro pode ser nulo ou uma cadeia de caracteres vazia.

Valor retornado

Esse método não retorna um valor.

Comentários

Depois que a mesclagem for concluída, os componentes no módulo serão anexados ao recurso identificado por Feature. Esse recurso não é criado e precisa ser um recurso existente. Observe que o método Merge obtém todas as referências de recurso no módulo e substitui a referência de recurso de todas as ocorrências do GUID nulo no banco de dados do módulo. Para obter mais informações, confira Referenciando recursos em módulos de mesclagem.

O módulo pode ser anexado a recursos adicionais por meio do método Connect. Observe que chamar o método Connect cria apenas associações de componentes de recurso. Não modifica as linhas que já foram mescladas no banco de dados.

As alterações feitas no banco de dados serão salvas se e somente se o método CloseDatabase for chamado com bCommit definido como TRUE.

Se ocorrerem conflitos de mesclagem, incluindo exclusões, eles serão colocados no enumerador de erro para recuperação posterior, mas não causarão nenhuma falha na mesclagem. Erros podem ser recuperados por meio da propriedade Errors. Erros e mensagens informativas são postados no arquivo de log atual.

C++

Confira a função Merge.

Requisitos

Requisito Valor
Versão
Mergemod.dll 1.0 ou versões posteriores
parâmetro
Mergemod.h
DLL
Mergemod.dll