Método Database.ApplyTransform

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