EventLogInstaller.Install(IDictionary) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Realiza a instalação e escreve a informação do registo de eventos no registo.
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
É IDictionary usado para guardar a informação necessária para realizar uma operação de rollback ou desinstalação.
Exceções
O nome especificado na Source propriedade já está registado num registo de eventos diferente.
Observações
O Install método escreve a informação do registo de eventos no registo e associa o registo de eventos a um registo especificado pela Log propriedade. Se o registo ainda não existir (e uma fonte for especificada), Install cria-se um registo e associa-lhe a nova fonte.
Normalmente, não chamas os métodos EventLogInstaller do from dentro do teu código; geralmente são chamados apenas pelo Installutil.exe (Ferramenta de Instalação). A ferramenta chama automaticamente o Install método durante o processo de instalação para escrever a informação do registo associada ao registo de eventos que está a ser instalado. A instalação é transacional, por isso, se houver uma falha de qualquer componente do projeto de instalação durante a instalação, todos os componentes previamente instalados são revertidos aos seus estados pré-instalação. Isto é conseguido chamando o método de Rollback cada componente.
Use EventLogInstaller para registar uma nova fonte para um registo 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 fonte existente para corresponder às propriedades de instalação especificadas. O Install método lança uma exceção se a Source propriedade corresponder a um nome de origem registado para um registo de eventos diferente no computador. O Install método ignora o registo da fonte se a Source propriedade corresponder a um nome de fonte que já esteja registado para o mesmo registo de eventos especificado na Log propriedade.
A rotina de instalação de uma aplicação utiliza a propriedade do Installer.Context instalador do projeto para manter automaticamente a informação sobre os componentes que já foram instalados. Esta informação de estado, que é passada para Install como parâmetro stateSaver , é continuamente atualizada à medida que a ferramenta instala cada EventLogInstaller. Normalmente, não é necessário que o seu código modifique explicitamente esta informação de estado.