EventLogInstaller.Install(IDictionary) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Realiza la instalación y escribe la información del registro de eventos en el 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
IDictionary que se utiliza para guardar la información necesaria para realizar una operación de deshacer o desinstalar.
Excepciones
El nombre especificado en la propiedad Source ya está registrado para un registro de eventos diferente.
Comentarios
El Install método escribe información del registro de eventos en el Registro y asocia el registro de eventos a un registro especificado por la Log propiedad . Si el registro aún no existe (y se especifica un origen), Install crea un registro y asocia el nuevo origen con él.
Normalmente, no se llama a los métodos del desde dentro del EventLogInstaller código; por lo general, los llama únicamente el Installutil.exe (Herramienta instalador). La herramienta llama automáticamente al Install método durante el proceso de instalación para escribir información del Registro asociada al registro de eventos que se está instalando. La instalación es transaccional, por lo que si se produce un error en cualquier componente de proyecto de instalación durante la instalación, todos los componentes instalados anteriormente se revierten a sus estados de preinstalación. Esto se logra llamando al método de Rollback cada componente.
Use EventLogInstaller para registrar un nuevo origen para un registro de eventos nuevo o existente; no use EventLogInstaller para cambiar un origen existente. La EventLogInstaller clase no modifica las propiedades de configuración de un origen existente para que coincidan con las propiedades de instalación especificadas. El Install método produce una excepción si la Source propiedad coincide con un nombre de origen registrado para un registro de eventos diferente en el equipo. El Install método omite el registro del origen si la Source propiedad coincide con un nombre de origen que ya está registrado para el mismo registro de eventos especificado en la Log propiedad .
La rutina de instalación de una aplicación usa la propiedad del instalador del Installer.Context proyecto para mantener automáticamente información sobre los componentes que ya se han instalado. Esta información de estado, que se pasa al InstallstateSaver parámetro , se actualiza continuamente a medida que la herramienta instala cada EventLogInstaller. Normalmente, no es necesario que el código modifique explícitamente esta información de estado.
