EventLogInstaller Clase

Definición

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

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

Use la EventLogInstaller clase cuando la aplicación escriba 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 dispositivos deben escribir en el registro del sistema.

El instalador crea el origen del evento que se especifica en la Source propiedad y lo registra para el registro de eventos especificado en la Log propiedad . Este comportamiento es similar a llamar CreateEventSource a en el 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 o EventLogInstallermediante 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 en true. 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 la Installutil.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 objeto 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 propiedad si la Source 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 del 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 categorías de eventos, mensajes y 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 con 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

Propiedades

Métodos

Eventos

Se aplica a

Consulte también

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