EventLogInstaller.Install(IDictionary) Método

public:
 override void Install(System::Collections::IDictionary ^ stateSaver);

public override void Install (System.Collections.IDictionary stateSaver);

override this.Install : System.Collections.IDictionary -> unit

Public Overrides Sub Install (stateSaver As IDictionary)

Parâmetros

Exceções

Comentários

O Install método grava informações de log de eventos no registro e associa o log de eventos a um log especificado pela Log propriedade . Se o log ainda não existir (e uma origem for especificada), Install criará um log e associará a nova fonte a ele.

Normalmente, você não chama os métodos do de dentro do EventLogInstaller seu código; eles geralmente são chamados apenas pelo Installutil.exe (Ferramenta do Instalador). A ferramenta chama automaticamente o Install método durante o processo de instalação para gravar informações do Registro associadas ao log de eventos que está sendo instalado. A instalação é transacional, portanto, se houver uma falha de qualquer componente do projeto de instalação durante a instalação, todos os componentes instalados anteriormente serão revertidos para seus estados de pré-instalação. Isso é feito chamando o método de Rollback cada componente.

Use EventLogInstaller para registrar uma nova fonte para um log de eventos novo ou existente; não use EventLogInstaller para alterar uma fonte existente. A EventLogInstaller classe não modifica as propriedades de configuração de uma origem existente para corresponder às propriedades de instalação especificadas. O Install método gerará uma exceção se a propriedade corresponder a Source um nome de origem registrado para um log de eventos diferente no computador. O Install método ignora o registro da origem se a propriedade corresponder a Source um nome de origem que já está registrado para o mesmo log de eventos especificado na Log propriedade .

A rotina de instalação de um aplicativo usa a propriedade do instalador do Installer.Context projeto para manter automaticamente informações sobre os componentes que já foram instalados. Essas informações de estado, que são passadas para como o stateSaver parâmetro , são atualizadas continuamente à Install medida que a ferramenta instala cada EventLogInstaller. Normalmente, não é necessário que seu código modifique explicitamente essas informações de estado.

Aplica-se a

Confira também

• Rollback(IDictionary)
• Uninstall(IDictionary)
• IDictionary