Compartilhar via

Método Database.ApplyTransform

  • Artigo

O método ApplyTransform do objeto Database aplica a transformação a esse banco de dados.

Sintaxe

Database.ApplyTransform(
  storage,
  errorConditions
)

Parâmetros

storage

Caminho para o arquivo de transformação que está sendo aplicado. Este parâmetro é necessário.

errorConditions

Especifica as condições de erro que devem ser suprimidas. Especifique-o como uma combinação dos valores inteiros a seguir.

Condição de erro Significado
msiTransformErrorAddExistingRow
0x0001
 Adiciona uma linha que já existe.
msiTransformErrorDeleteNonExistingRow
0x0002
 Exclui uma linha que não existe.
msiTransformErrorAddExistingTable
0x0004
 Adiciona uma tabela que já existe.
msiTransformErrorDeleteNonExistingTable
0x0008
 Exclui uma tabela que não existe.
msiTransformErrorUpdateNonExistingRow
0x0010
 Atualiza uma linha que não existe.
msiTransformErrorChangeCodePage
0x0020
 As páginas de código de transformação e de banco de dados não são correspondentes, e nenhuma delas tem uma página de código neutro.
msiTransformErrorViewTransform
0x0100
 Cria a tabela _TransformView temporária.

Valor retornado

Esse método não retorna um valor.

Comentários

O método ApplyTransform atrasa a transformação de tabelas até o último momento possível. As etapas executadas em ApplyTransform se destinam a transformar imediatamente os catálogos de tabelas e de colunas do banco de dados. Os catálogos de tabelas e de colunas são atualizados de acordo com a tabela que é adicionada ou excluída e a coluna que é adicionada (nenhuma exclusão de colunas é permitida). Se uma tabela estiver carregada na memória e precisar ser transformada, ela será transformada. Caso contrário, o estado da tabela é definido como aquele que exige uma transformação de modo que, quando a tabela for carregada ou quando o banco de dados for confirmado, a transformação seja aplicada. Transformação nessa instância significa que os dados reais (linha) da tabela são adicionados, excluídos ou atualizados.

Em caso de falha do método, obtenha informações sobre os erros estendidos usando o método LastErrorRecord.

Requisitos

Requisito Valor
Versão
 Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP
DLL
Msi.dll
IID
 O IID_IDatabase é definido como 000C109D-0000-0000-C000-000000000046

Confira também

Banco de dados

Transformações de banco de dados