Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método EventLogInstaller.Install (IDictionary)

 

Publicado: octubre de 2016

Realiza la instalación y escribe la información de 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
)

Parámetros

stateSaver
Type: System.Collections.IDictionary

Un IDictionary usado para guardar la información necesaria para realizar una operación de deshacer o desinstalar.

Exception Condition
PlatformNotSupportedException

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

ArgumentException

El nombre especificado en el Source propiedad ya está registrada para otro registro de eventos.

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

Normalmente, no se llama los métodos de la EventLogInstaller desde dentro del código; se suele llamar solo el Installutil.exe (Installer Tool). La herramienta llama automáticamente el Install método durante el proceso de instalación para escribir la información del registro que está asociado con el registro de eventos que se va a instalar. La instalación es transaccional, por lo que si se produce un error de cualquier componente del proyecto de instalación durante la instalación, todos los componentes previamente instalados vuelven a su estado previo de instalación. Esto se logra mediante una llamada a cada componente Rollback método.

Utilice 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 coincida con las propiedades de instalación especificado. El Install método produce una excepción si el Source propiedad coincide con un nombre de origen que está registrado para otro registro de eventos en el equipo. El Install método omite el registro del origen si la Source propiedad coincide con un nombre de origen ya está registrado para el mismo registro de eventos especificado en el Log propiedad.

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

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: