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

Clase EventLogInstaller

 

Publicado: octubre de 2016

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

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

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Configuration.Install.Installer
        System.Configuration.Install.ComponentInstaller
          System.Diagnostics.EventLogInstaller

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 provocar 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 la Component está actualmente en modo de diseño.(Heredado de Component).

System_CAPS_protpropertyEvents

Obtiene la lista de controladores de eventos que se adjuntará a este 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 para establecer el origen en.

System_CAPS_pubpropertyMessageResourceFile

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

System_CAPS_pubpropertyParameterResourceFile

Obtiene o establece la ruta de acceso del archivo de recursos que contiene 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 la ISite de la Component.(Heredado de Component).

System_CAPS_pubpropertySource

Obtiene o establece el nombre de origen para registrar con el registro.

System_CAPS_pubpropertyUninstallAction

Obtiene o establece un valor que indica si el Installutil.exe (Installer Tool) debe quitar el registro de eventos o déjelo en su estado de instalación 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 EventLog los componentes que son necesarios durante la instalación para un registro de eventos.(Invalida ComponentInstaller.CopyFromComponent(IComponent)).

System_CAPS_pubmethodCreateObjRef(Type)

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

System_CAPS_pubmethodDispose()

Libera todos los recursos que usa Component.(Heredado de Component).

System_CAPS_protmethodDispose(Boolean)

Libera los recursos no administrados que usa 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 elemento Component durante la recolección de elementos no usados.(Heredado de Component).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(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 de registro de eventos en el registro.(Invalida Installer.Install(IDictionary)).

System_CAPS_pubmethodIsEquivalentInstaller(ComponentInstaller)

Determina si un instalador y otro instalador especificado hacen referencia al mismo origen.(Invalida 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 elemento actual MarshalByRefObject objeto.(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 de registro de eventos que el procedimiento de instalación escribió en el registro.(Invalida Installer.Rollback(IDictionary)).

System_CAPS_pubmethodToString()

Devuelve un String que contiene el nombre de la Component, si existe. Este método no se debe invalidar.(Heredado de Component).

System_CAPS_pubmethodUninstall(IDictionary)

Quita una instalación quitando la información de registro de eventos del registro.(Invalida 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 a la Dispose (método).(Heredado de Component).

El EventLogInstaller es utilizado por la Installutil.exe (Installer Tool) al instalar un registro de eventos. La EventLogInstaller clase sólo puede instalar registros de eventos en el equipo local.

Utilice la EventLogInstaller clase cuando la aplicación se escribe en un registro de eventos; no es necesario usar un instalador de registro de eventos de la aplicación para leer de un registro de eventos. Aplicaciones y servicios deben escribir en el registro de aplicación o un registro personalizado. Controladores de dispositivos deben escribir en el registro del sistema.

System_CAPS_noteNota

El registro de seguridad es de solo lectura.

El instalador crea el origen del evento que se especifica en el Source propiedad y se registra para el registro de eventos especificado en Log propiedad. Este comportamiento es similar a llamar a CreateEventSource en el EventLog componente.

Utilice la WriteEvent y WriteEntry métodos para escribir eventos en un registro de eventos. Debe especificar un origen de eventos para escribir los eventos; debe crear y configurar el origen del evento antes de escribir la primera entrada con el origen.

Crear el nuevo origen de eventos durante la instalación de la aplicación. Esto da tiempo para el sistema operativo actualizar la lista de orígenes de eventos registrados y sus configuraciones. Si el sistema operativo no ha actualizado su lista de orígenes de eventos y se intenta escribir un evento con el nuevo origen, que se producirá un error en la operación de escritura. Puede configurar un nuevo origen mediante un EventLogInstaller, o mediante el CreateEventSource método. Debe tener derechos administrativos en el equipo para crear un nuevo origen de eventos.

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

Para instalar un registro de eventos, cree una clase de instalador del proyecto que herede de Installer, y establecer el RunInstallerAttribute para la clase true. Dentro del proyecto, cree un EventLogInstaller para cada registro de eventos que escribirá la aplicación y agregue la instancia a la clase de instalador del proyecto.

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

Modificar otras propiedades de un EventLogInstaller antes o después de agregar la instancia a la Installers colección del instalador del proyecto, pero antes de ejecuta la herramienta de instalación. Debe establecer el Source propiedad si la aplicación va a escribir en el registro de eventos.

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 registra el 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.

Puede registrar el origen de eventos con archivos de recursos adaptados para las cadenas de categoría y el mensaje de evento. La aplicación puede escribir entradas del registro de eventos con identificadores de recursos, en lugar de especificar la cadena real. El Visor de eventos utiliza el identificador del recurso para buscar y mostrar la cadena correspondiente del archivo de recursos localizados según la configuración de idioma actual. Puede registrarse un archivo independiente para las categorías de eventos, mensajes y las cadenas de inserción de parámetro, o puede registrar el mismo archivo de recursos para los tres tipos de cadenas. Utilice la CategoryCount, CategoryResourceFile, MessageResourceFile, y ParameterResourceFile Propiedades para configurar el origen para escribir entradas adaptadas en el registro de eventos. Si la aplicación escribe valores de cadena directamente en el registro de eventos, no es necesario establecer estas propiedades.

El origen debe configurarse para escribir entradas adaptadas o cadenas directas. Si la aplicación escribe las entradas mediante identificadores de recursos y valores de cadena, debe registrarse dos orígenes diferentes. Por ejemplo, configurar un origen con archivos de recursos y, a continuación, usar ese origen en el WriteEvent método para escribir entradas mediante identificadores de recursos en el registro de eventos. Crear un origen diferente sin archivos de recursos y, a continuación, usar ese origen en el WriteEntry método para escribir cadenas directamente en el registro de eventos utilizando ese origen.

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

Win98WinMe

Event logs are not supported on Windows 98/Windows Millennium Edition (Me).

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

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

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: