EventLogInstaller Clase
TOC
Collapse the table of content
Expand the table of content
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

EventLogInstaller (Clase)

 

Permite instalar y configurar un registro de eventos en el que la aplicación lee o escribe cuando se ejecuta.

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


public class EventLogInstaller : ComponentInstaller

NombreDescripción
System_CAPS_pubmethodEventLogInstaller()

Inicializa una nueva instancia de la clase EventLogInstaller.

NombreDescripción
System_CAPS_protpropertyCanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.(Heredado de Component.)

System_CAPS_pubpropertyCategoryCount

Obtiene o establece el número de categorías en el archivo de recursos de categoría.

System_CAPS_pubpropertyCategoryResourceFile

Obtiene o establece la ruta de acceso del archivo de recursos que contiene las cadenas de categoría para el origen.

System_CAPS_pubpropertyContainer

Obtiene IContainer que contiene Component.(Heredado de Component.)

System_CAPS_pubpropertyContext

Obtiene o establece información sobre la instalación actual.(Heredado de Installer.)

System_CAPS_protpropertyDesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.(Heredado de Component.)

System_CAPS_protpropertyEvents

Obtiene la lista de controladores de eventos asociados a Component.(Heredado de Component.)

System_CAPS_pubpropertyHelpText

Obtiene el texto de ayuda de todos los instaladores que se encuentran en la colección de instaladores.(Heredado de Installer.)

System_CAPS_pubpropertyInstallers

Obtiene la colección de instaladores que contiene este instalador.(Heredado de Installer.)

System_CAPS_pubpropertyLog

Obtiene o establece el nombre del registro en el que hay que establecer el origen.

System_CAPS_pubpropertyMessageResourceFile

Obtiene o establece la ruta de acceso del archivo de recursos que contiene las cadenas de formato de mensaje para el origen.

System_CAPS_pubpropertyParameterResourceFile

Obtiene o establece la ruta de acceso del archivo de recursos que contiene las cadenas de parámetros de mensaje para el origen.

System_CAPS_pubpropertyParent

Obtiene o establece el instalador que contiene la colección a la que pertenece este instalador.(Heredado de Installer.)

System_CAPS_pubpropertySite

Obtiene o establece ISite de Component.(Heredado de Component.)

System_CAPS_pubpropertySource

Obtiene o establece el nombre del origen que se va a registrar con el registro.

System_CAPS_pubpropertyUninstallAction

Obtiene o establece un valor que indica si Installutil.exe (Herramienta Installer) debe quitar el registro de eventos o dejarlo en su estado instalado, en el momento de la desinstalación.

NombreDescripción
System_CAPS_pubmethodCommit(IDictionary)

Cuando se reemplaza en una clase derivada, finaliza la transacción de instalación.(Heredado de Installer.)

System_CAPS_pubmethodCopyFromComponent(IComponent)

Copia los valores de propiedad de un componente EventLog que se necesitan durante la instalación para un registro de eventos.(Reemplaza a ComponentInstaller.CopyFromComponent(IComponent)).

System_CAPS_pubmethodCreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.(Heredado de MarshalByRefObject.)

System_CAPS_pubmethodDispose()

Libera todos los recursos utilizados por Component.(Heredado de Component.)

System_CAPS_protmethodDispose(Boolean)

Libera los recursos no administrados que utiliza Component y libera los recursos administrados de forma opcional.(Heredado de Component.)

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object.)

System_CAPS_protmethodFinalize()

Libera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el objeto Component durante la recolección de elementos no utilizados.(Heredado de Component.)

System_CAPS_pubmethodGetHashCode()

Sirve como una función hash para un tipo en particular. (Heredado de Object.)

System_CAPS_pubmethodGetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.(Heredado de MarshalByRefObject.)

System_CAPS_protmethodGetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.(Heredado de Component.)

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual. (Heredado de Object.)

System_CAPS_pubmethodInitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.(Heredado de MarshalByRefObject.)

System_CAPS_pubmethodInstall(IDictionary)

Realiza la instalación y escribe la información del registro de eventos en el Registro.(Reemplaza a Installer.Install(IDictionary)).

System_CAPS_pubmethodIsEquivalentInstaller(ComponentInstaller)

Determina si un instalador y otro instalador especificado hacen referencia al mismo origen.(Reemplaza a ComponentInstaller.IsEquivalentInstaller(ComponentInstaller)).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual. (Heredado de Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.(Heredado de MarshalByRefObject.)

System_CAPS_protmethodOnAfterInstall(IDictionary)

Genera el evento AfterInstall.(Heredado de Installer.)

System_CAPS_protmethodOnAfterRollback(IDictionary)

Genera el evento AfterRollback.(Heredado de Installer.)

System_CAPS_protmethodOnAfterUninstall(IDictionary)

Genera el evento AfterUninstall.(Heredado de Installer.)

System_CAPS_protmethodOnBeforeInstall(IDictionary)

Genera el evento BeforeInstall.(Heredado de Installer.)

System_CAPS_protmethodOnBeforeRollback(IDictionary)

Genera el evento BeforeRollback.(Heredado de Installer.)

System_CAPS_protmethodOnBeforeUninstall(IDictionary)

Genera el evento BeforeUninstall.(Heredado de Installer.)

System_CAPS_protmethodOnCommitted(IDictionary)

Genera el evento Committed.(Heredado de Installer.)

System_CAPS_protmethodOnCommitting(IDictionary)

Genera el evento Committing.(Heredado de Installer.)

System_CAPS_pubmethodRollback(IDictionary)

Restaura el equipo al estado que tenía antes de la instalación, deshaciendo la información del registro de eventos que el procedimiento de instalación escribió en el Registro.(Reemplaza a Installer.Rollback(IDictionary)).

System_CAPS_pubmethodToString()

Devuelve un objeto String que contiene el nombre del objeto Component, en caso de que exista.Este método no debe reemplazarse.(Heredado de Component.)

System_CAPS_pubmethodUninstall(IDictionary)

Quita una instalación suprimiendo la información del registro de eventos del Registro.(Reemplaza a Installer.Uninstall(IDictionary)).

NombreDescripción
System_CAPS_pubeventAfterInstall

Se produce después de ejecutarse los métodos Install de todos los instaladores de la propiedad Installers.(Heredado de Installer.)

System_CAPS_pubeventAfterRollback

Se produce después de deshacerse la instalación de todos los instaladores de la propiedad Installers.(Heredado de Installer.)

System_CAPS_pubeventAfterUninstall

Se produce después de que todos los instaladores de la propiedad Installers realicen sus operaciones de desinstalación.(Heredado de Installer.)

System_CAPS_pubeventBeforeInstall

Se produce antes de ejecutarse el método Install de cada instalador en la colección de instaladores.(Heredado de Installer.)

System_CAPS_pubeventBeforeRollback

Se produce antes de deshacerse los instaladores de la propiedad Installers.(Heredado de Installer.)

System_CAPS_pubeventBeforeUninstall

Se produce antes de que los instaladores de la propiedad Installers realicen sus operaciones de desinstalación.(Heredado de Installer.)

System_CAPS_pubeventCommitted

Se produce después de que todos los instaladores de la propiedad Installers confirmen sus instalaciones.(Heredado de Installer.)

System_CAPS_pubeventCommitting

Se produce antes de que los instaladores de la propiedad Installers confirmen sus instalaciones.(Heredado de Installer.)

System_CAPS_pubeventDisposed

Se produce cuando el componente se elimina mediante una llamada al método Dispose. (Heredado de Component.)

Installutil.exe (Herramienta Installer) utiliza la clase EventLogInstaller cuando se instala un registro de eventos.La clase EventLogInstaller sólo puede instalar registros de eventos en el equipo local.

Utilice la clase EventLogInstaller cuando la aplicación escriba en un registro de eventos; no es necesario utilizar un instalador de registro de eventos para que la aplicación lea un registro de eventos.Las aplicaciones y los servicios deben escribir en el registro de aplicaciones o en un registro personalizado.Los controladores de dispositivos deben escribir en el Registro del sistema.

System_CAPS_noteNota

El registro de seguridad es de sólo lectura.

El instalador crea el origen de eventos especificado en la propiedad Source y lo registra para el registro de eventos especificado en la propiedad Log.Este comportamiento es muy parecido a llamar a CreateEventSource en el componente EventLog.

Utilice los métodos WriteEvent y WriteEntry para escribir eventos en un registro de eventos.Para escribir eventos, es necesario especificar un origen de eventos; asimismo, antes de escribir la primera entrada con el origen, es necesario crearlo y configurarlo.

El nuevo origen de eventos deberá crearse durante la instalación de la aplicación.De esta manera, el sistema operativo dispondrá de tiempo para actualizar la lista de orígenes de eventos registrados y sus configuraciones.Si el sistema operativo aún no ha actualizado la lista de orígenes de eventos y se intenta escribir un evento con el nuevo origen, se producirá un error en la operación de escritura.Para configurar un nuevo origen, puede utilizarse EventLogInstaller o el método CreateEventSource.Es necesario contar con derechos administrativos en el equipo para crear un nuevo origen de eventos.

Puede crearse un origen de eventos para un registro de eventos ya existente o para uno nuevo.Cuando se crea un origen para un registro de eventos nuevo, el sistema registra el origen de ese registro, pero éste no se crea hasta que no se escriba la primera entrada en él.

Para instalar un registro de eventos, cree una clase de instalador del proyecto que se herede de Installer y establezca RunInstallerAttribute de la clase en true.En el proyecto, cree un objeto EventLogInstaller para cada registro de eventos en el que vaya a escribir la aplicación y agregue la instancia a la clase de instalador del proyecto.

Cuando se llama a Installutil.exe (Herramienta Installer), examina RunInstallerAttribute.Si es true, la herramienta instala todos los elementos de la colección de Installers asociados al instalador del proyecto.Si RunInstallerAttribute es false, la herramienta omite el instalador del proyecto.

El resto de las propiedades de EventLogInstaller se modifica antes o después de agregar la instancia a la colección de Installers del instalador del proyecto, pero antes de ejecutar la herramienta de instalación.Se debe establecer la propiedad Source si la aplicación va a escribir entradas en el registro de eventos.

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 no registra el origen si la propiedad Source coincide con un nombre de origen ya registrado para el mismo registro de eventos especificado en la propiedad Log.

El origen de eventos puede registrarse con archivos de recursos adaptados para la categoría de eventos y las cadenas de mensaje.Una aplicación puede escribir entradas del registro de eventos mediante identificadores de recursos en lugar de especificar la cadena real.El visor de eventos utiliza el identificador del recurso para buscar y mostrar la correspondiente cadena del archivo de recursos adaptado en función de la configuración de idioma actual.Puede registrarse un archivo independiente para las cadenas de categoría de eventos, mensajes e inserción de parámetros, o bien un mismo archivo de recursos para los tres tipos de cadenas.Las propiedades CategoryCount, CategoryResourceFile, MessageResourceFile y ParameterResourceFile se emplean para configurar un origen para la escritura de entradas adaptadas en el registro de eventos.Cuando una aplicación escribe valores de cadena directamente en el registro de eventos, no es necesario establecer estas propiedades.

El origen deberá configurarse para escribir o bien entradas adaptadas o bien cadenas directas.Cuando una aplicación escriba entradas usando tanto identificadores de recursos como valores de cadena, deberán registrarse dos orígenes diferentes.Por ejemplo, puede configurarse un origen con archivos de recursos y usarlo en el método WriteEvent para escribir entradas en el registro de eventos mediante identificadores de recursos.Cree un origen diferente sin archivos de recursos y, a continuación, utilícelo en el método WriteEntry para escribir cadenas directamente en el registro de eventos utilizando ese origen.

Normalmente, no se llama a los métodos de la clase EventLogInstaller desde el código; se les suele llamar solo desde Installutil.exe.La herramienta llama automáticamente al método Install durante el proceso de instalación.Deshace los errores, si es necesario, mediante una llamada al método Rollback para el objeto que generó la excepción.

Win98WinMe

Los registros de eventos no son compatibles con Windows 98 ni Windows Millennium (Me).

En el ejemplo de código siguiente se establecen las propiedades de instalación para un nuevo origen de eventos.El ejemplo de código establece el nombre de origen y el nombre del registro de eventos y agrega EventLogInstaller a la colección de Installers.

using System;
using System.Configuration.Install;
using System.Diagnostics;
using System.ComponentModel;

[RunInstaller(true)]
public class MyEventLogInstaller: Installer
{
    private EventLogInstaller myEventLogInstaller;

    public MyEventLogInstaller() 
    {
        // Create an instance of an EventLogInstaller.
        myEventLogInstaller = new EventLogInstaller();

        // Set the source name of the event log.
        myEventLogInstaller.Source = "NewLogSource";

        // Set the event log that the source writes entries to.
        myEventLogInstaller.Log = "MyNewLog";

        // Add myEventLogInstaller to the Installer collection.
        Installers.Add(myEventLogInstaller);   
    }

    public static void Main()
    {
        MyEventLogInstaller myInstaller = new MyEventLogInstaller();
    }
}

.NET Framework
Disponible desde 1.1

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Volver al principio
Mostrar:
© 2016 Microsoft