EventLogInstaller.Install(IDictionary) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Executa a instalação e grava as informações de log de eventos no registro.
public:
override void Install(System::Collections::IDictionary ^ stateSaver);public override void Install (System.Collections.IDictionary stateSaver);override this.Install : System.Collections.IDictionary -> unitPublic Overrides Sub Install (stateSaver As IDictionary)Parâmetros
- stateSaver
- IDictionary
Um IDictionary usado para salvar as informações necessárias para realizar uma operação de reversão ou desinstalação.
Exceções
O nome especificado na propriedade Source já está registrado para outro log de eventos.
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.
