Esta documentación está archivada y no tiene mantenimiento.

EventLogInstaller.Install (Método)

Actualización: noviembre 2007

Realiza la instalación y escribe la información del registro de eventos en el Registro.

Espacio de nombres:  System.Diagnostics
Ensamblado:  System.Configuration.Install (en System.Configuration.Install.dll)

public override void Install(
	IDictionary stateSaver
)
public void Install(
	IDictionary stateSaver
)
public override function Install(
	stateSaver : IDictionary
)

Parámetros

stateSaver
Tipo: System.Collections.IDictionary
IDictionary que se utiliza para guardar la información necesaria para realizar una operación de deshacer o desinstalar.

ExcepciónCondición
PlatformNotSupportedException

La plataforma que el instalador está intentando usar no es Windows NT 4.0 o posterior.

ArgumentException

El nombre especificado en la propiedad Source ya está registrado para un registro de eventos diferente.

El método Install escribe la información del registro de eventos en el Registro y asocia el registro de eventos a un registro especificado por la propiedad Log. Si el registro no existe todavía (y se especifica un origen), Install crea un registro y le asocia el nuevo origen.

Normalmente, no se llama a los métodos de EventLogInstaller desde el código; habitualmente, sólo se les llama desde Herramienta Installer (Installutil.exe). La herramienta llama automáticamente al método Install durante el proceso de instalación para escribir la 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 alguno de los componentes del proyecto de instalación durante el proceso de instalación, todos los componentes previamente instalados vuelven a los estados que tenían antes de la instalación. Esta operación se realiza llamando al método Rollback de cada componente.

Utilice EventLogInstaller para registrar un origen nuevo para un registro de eventos nuevo o existente; no utilice EventLogInstaller para cambiar un origen ya existente. La clase EventLogInstaller no modifica las propiedades de configuración de un origen existente para que coincidan con las propiedades de instalación especificadas. El método Install produce una excepción si la propiedad Source coincide con un nombre de origen que ya está registrado para otro registro de eventos del equipo. El método Install omite el registro del origen si la propiedad Source coincide con un nombre de origen ya registrado para el mismo registro de eventos especificado en la propiedad Log.

La rutina de instalación de una aplicación utiliza la propiedad Installer.Context del instalador del proyecto para mantener de forma automática la información acerca de los componentes que ya se han instalado. Esta información de estado, que se pasa a Install como parámetro stateSaver, se actualiza periódicamente a medida que la herramienta va instalando cada EventLogInstaller. Normalmente no es necesario que el código modifique esta información de estado de manera explícita.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0
Mostrar: