EventLogInstaller Clase

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Configuration.Install.dll

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

public ref class EventLogInstaller : System::Configuration::Install::ComponentInstaller

public class EventLogInstaller : System.Configuration.Install.ComponentInstaller

type EventLogInstaller = class
    inherit ComponentInstaller

Public Class EventLogInstaller
Inherits ComponentInstaller

Herencia

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

EventLogInstaller

Ejemplos

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

#using <System.dll>
#using <System.Configuration.Install.dll>

using namespace System;
using namespace System::Configuration::Install;
using namespace System::Diagnostics;
using namespace System::ComponentModel;

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

public:
   MyEventLogInstaller()
   {
      // Create an instance of an EventLogInstaller.
      myEventLogInstaller = gcnew 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 );
   }
};

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();
    }
}

   Imports System.Configuration.Install
Imports System.Diagnostics
Imports System.ComponentModel

<RunInstaller(True)>  _
Public Class MyEventLogInstaller
   Inherits Installer
   Private myEventLogInstaller As EventLogInstaller
   
   Public Sub New()

      ' 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)
   End Sub

 Public Shared Sub Main()
 End Sub
 Dim myInstaller As New EventLogInstaller()
End Class

Comentarios

el Installutil.exe (herramienta instalador) usa el EventLogInstaller objeto al instalar un registro de eventos. La EventLogInstaller clase solo puede instalar registros de eventos en el equipo local.

Use la clase cuando la EventLogInstaller aplicación escribe en un registro de eventos; no es necesario usar un instalador de registro de eventos para que la aplicación lea desde un registro de eventos. Las aplicaciones y los servicios deben escribir en el registro de aplicaciones o en un registro personalizado. Los controladores de dispositivo deben escribir en el registro del sistema.

Nota

El registro de seguridad es de solo lectura.

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

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

Cree el nuevo origen de eventos durante la instalación de la aplicación. Esto permite que el sistema operativo actualice su lista de orígenes de eventos registrados y sus configuraciones. Si el sistema operativo no ha actualizado su lista de orígenes de eventos e intenta escribir un evento con el nuevo origen, se producirá un error en la operación de escritura. Puede configurar un nuevo origen mediante 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 nuevo registro de eventos. Cuando se crea un nuevo origen para un nuevo registro de eventos, el sistema registra el origen de ese registro, pero el registro no se crea hasta que se escribe la primera entrada.

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

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

Puede modificar otras propiedades de un EventLogInstaller elemento antes o después de agregar la instancia a la Installers colección del instalador del proyecto, pero antes de que se ejecute la herramienta del instalador. Debe establecer la Source propiedad si la aplicación escribirá en el registro de eventos.

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

Puede registrar el origen del evento con archivos de recursos localizados para la categoría de eventos y las cadenas de mensaje. La aplicación puede escribir entradas de registro de eventos mediante identificadores de recursos, en lugar de especificar la cadena real. El Visor de eventos usa el identificador de recursos para buscar y mostrar la cadena correspondiente del archivo de recursos localizado en función de la configuración de idioma actual. Puede registrar un archivo independiente para las categorías de eventos, los mensajes y las cadenas de inserción de parámetros, o puede registrar el mismo archivo de recursos para los tres tipos de cadenas. Use las CategoryCountpropiedades , CategoryResourceFile, MessageResourceFiley ParameterResourceFile para configurar el origen para escribir entradas localizadas en el registro de eventos. Si la aplicación escribe valores de cadenas directamente en el registro de eventos, no es necesario establecer estas propiedades.

El origen debe configurarse para escribir entradas localizadas o para escribir cadenas directas. Si la aplicación escribe entradas mediante identificadores de recursos y valores de cadena, debe registrar dos orígenes independientes. Por ejemplo, configure un origen con archivos de recursos y, a continuación, use ese origen en el WriteEvent método para escribir entradas mediante identificadores de recursos en el registro de eventos. Cree un origen diferente sin archivos de recursos y después use ese origen en el WriteEntry método para escribir cadenas directamente en el registro de eventos mediante ese origen.

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

Constructores

EventLogInstaller()

Inicializa una nueva instancia de la clase EventLogInstaller.

Propiedades

CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
CategoryCount	Obtiene o establece el número de categorías en el archivo de recursos de categoría.
CategoryResourceFile	Obtiene o establece la ruta de acceso del archivo de recursos que contiene las cadenas de categoría para el origen.
Container	Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
Context	Obtiene o establece información sobre la instalación actual. (Heredado de Installer)
DesignMode	Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component)
HelpText	Obtiene el texto de ayuda de todos los instaladores que se encuentran en la colección de instaladores. (Heredado de Installer)
Installers	Obtiene la colección de instaladores que contiene este instalador. (Heredado de Installer)
Log	Obtiene o establece el nombre del registro en el que hay que establecer el origen.
MessageResourceFile	Obtiene o establece la ruta de acceso del archivo de recursos que contiene las cadenas de formato de mensaje para el origen.
ParameterResourceFile	Obtiene o establece la ruta de acceso del archivo de recursos que contiene las cadenas de parámetros de mensaje para el origen.
Parent	Obtiene o establece el instalador que contiene la colección a la que pertenece este instalador. (Heredado de Installer)
Site	Obtiene o establece ISite de Component. (Heredado de Component)
Source	Obtiene o establece el nombre del origen que se va a registrar con el registro.
UninstallAction	Obtiene o establece un valor que indica si la herramienta de instalación Installutil.exe debe quitar el registro de eventos o dejarlo en su estado instalado, en el momento de la desinstalación.

Métodos

Commit(IDictionary)	Cuando se reemplaza en una clase derivada, finaliza la transacción de instalación. (Heredado de Installer)
CopyFromComponent(IComponent)	Copia los valores de propiedad de un componente EventLog que se necesitan durante la instalación para un registro de eventos.
CreateObjRef(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)
Dispose()	Libera todos los recursos que usa Component. (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados. (Heredado de Component)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetService(Type)	Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
Install(IDictionary)	Realiza la instalación y escribe la información del registro de eventos en el Registro.
IsEquivalentInstaller(ComponentInstaller)	Determina si un instalador y otro instalador especificado hacen referencia al mismo origen.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
OnAfterInstall(IDictionary)	Genera el evento AfterInstall. (Heredado de Installer)
OnAfterRollback(IDictionary)	Genera el evento AfterRollback. (Heredado de Installer)
OnAfterUninstall(IDictionary)	Genera el evento AfterUninstall. (Heredado de Installer)
OnBeforeInstall(IDictionary)	Genera el evento BeforeInstall. (Heredado de Installer)
OnBeforeRollback(IDictionary)	Genera el evento BeforeRollback. (Heredado de Installer)
OnBeforeUninstall(IDictionary)	Genera el evento BeforeUninstall. (Heredado de Installer)
OnCommitted(IDictionary)	Genera el evento Committed. (Heredado de Installer)
OnCommitting(IDictionary)	Genera el evento Committing. (Heredado de Installer)
Rollback(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.
ToString()	Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component)
Uninstall(IDictionary)	Quita una instalación suprimiendo la información del registro de eventos del Registro.

Eventos

AfterInstall	Se produce después de ejecutarse los métodos Install(IDictionary) de todos los instaladores de la propiedad Installers. (Heredado de Installer)
AfterRollback	Se produce después de deshacerse la instalación de todos los instaladores de la propiedad Installers. (Heredado de Installer)
AfterUninstall	Se produce después de que todos los instaladores de la propiedad Installers realicen sus operaciones de desinstalación. (Heredado de Installer)
BeforeInstall	Se produce antes de ejecutarse el método Install(IDictionary) de cada instalador en la colección de instaladores. (Heredado de Installer)
BeforeRollback	Se produce antes de deshacerse los instaladores de la propiedad Installers. (Heredado de Installer)
BeforeUninstall	Se produce antes de que los instaladores de la propiedad Installers realicen sus operaciones de desinstalación. (Heredado de Installer)
Committed	Se produce después de que todos los instaladores de la propiedad Installers confirmen sus instalaciones. (Heredado de Installer)
Committing	Se produce antes de que los instaladores de la propiedad Installers confirmen sus instalaciones. (Heredado de Installer)
Disposed	Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component)

Consulte también

• EventLog
• CreateEventSource
• Installutil.exe (Herramienta Installer)