System.Configuration.Install Espaço de Nomes

Fornece classes que permitem escrever instaladores personalizados para os seus próprios componentes. A classe Installer é a classe base para todos os instaladores personalizados no .NET Framework.

Classes

Name Description
AssemblyInstaller

Carrega um conjunto e executa todos os instaladores nele.

ComponentInstaller

Especifica um instalador que copia propriedades de um componente para usar no momento da instalação.

InstallContext

Contém informações sobre a instalação atual.

Installer

Fornece a base para instalações personalizadas.

InstallerCollection

Contém uma coleção de instaladores a serem executados durante uma instalação.

InstallEventArgs

Fornece dados para os eventos: BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollback, BeforeUninstall, , . AfterUninstall

InstallException

A exceção que é lançada quando ocorre um erro durante a fase de commit, rollback ou desinstalação de uma instalação.

ManagedInstallerClass

Representa uma instalação gerida.

TransactedInstaller

Define um instalador que ou tem sucesso completo ou falha e deixa o computador no seu estado inicial.

Interfaces

Name Description
IManagedInstaller

Fornece uma interface para um instalador gerido.

Enumerações

Name Description
UninstallAction

Especifica o que um instalador deve fazer durante uma desinstalação.

Delegados

Name Description
InstallEventHandler

Representa o método que irá tratar do BeforeInstall, AfterInstall, Committing, Committed, BeforeRollback, AfterRollbackBeforeUninstall, , ou AfterUninstall evento de um Installer.

Observações

Através da Installers propriedade, um instalador inclui um conjunto de outros instaladores quando crianças. À medida que o instalador é executado, ele percorre os seus filhos e chama Install, Commit, Rollback, ou Uninstall. Para um exemplo de um objeto na Installers coleção, veja EventLogInstaller.

A Context propriedade contém informações sobre a instalação. Por exemplo, informação sobre a localização do ficheiro de registo da instalação, a localização do ficheiro que guarda a informação exigida pelo Uninstall método e a linha de comandos que foi introduzida quando o executável da instalação foi executado. Para um exemplo de executável de instalação, veja Installutil.exe (Ferramenta de Instalação).

Os Installmétodos , Commit, Rollback, e Uninstall nem sempre são chamados na mesma instância de Installer. Por exemplo, pode usar um Installer para instalar e confirmar uma aplicação, e depois libertar a referência a essa Installeraplicação. Mais tarde, ao desinstalar a aplicação, cria-se uma nova referência para um Installer, o que significa que o Uninstall método é chamado numa instância diferente de Installer. Por esta razão, não guarde o estado de um computador num instalador. Em vez disso, use an IDictionary que é preservado entre chamadas e passado para os Installmétodos , Commit, Rollback, e Uninstall .