Cómo: Agregar una aplicación como origen de entradas de un registro de eventos

Actualización: noviembre 2007

Para que el componente pueda escribir una entrada en un registro de eventos, deberá registrarlo con el registro de eventos como un origen de eventos válido. Para ello, utilice el método CreateEventSource y especifique una cadena que identifique de forma unívoca el componente en el registro de eventos. Cuando escriba una entrada de registro, el sistema utilizará el origen identificado con el fin de buscar el registro adecuado para colocar la entrada. La instancia del componente EventLog sólo puede escribir en un único registro cada vez.

Nota:

De forma predeterminada, si intenta escribir una entrada sin haber registrado primero el componente como un origen válido, el sistema registrará automáticamente el origen con el registro de eventos y utilizará el valor de la propiedad Source como cadena de origen. Por norma general, cree el nuevo origen de eventos durante la instalación de su aplicación. Esto permite al sistema operativo actualizar con tiempo la lista de orígenes de eventos registrados y su configuración. 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. Si no es posible crear el origen durante la instalación, intente crear el origen bastante antes de la primera operación de escritura, tal vez durante la inicialización de la aplicación. Si elige esta opción, asegúrese de que el código de la inicialización se está ejecutando con derechos de administrador en el equipo. Estos derechos son necesarios para crear nuevos orígenes de eventos.

Si especifica el nombre de un registro que no existe cuando utiliza el método CreateEventSource, el sistema creará un nuevo registro de eventos personalizado con ese nombre la primera vez que intente escribir una entrada en el registro. Para obtener más información, vea Cómo: Crear y quitar registros de eventos personalizados.

Puede registrar el origen de eventos con los recursos adaptados en la categoría de evento y las cadenas de mensaje. La aplicación puede escribir entradas en el registro de eventos utilizando los identificadores de recursos, en lugar de especificar los valores de cadena reales. Vea las clases EventLogInstaller y EventSourceCreationData para obtener más información sobre cómo configurar su origen con archivos de recursos.

Para establecer un componente como origen de eventos

• Para crear entradas en el equipo local, llame al método CreateEventSource y especifique como parámetros la cadena de origen y el nombre de registro.

  Nota:
  Si deja el nombre de registro en blanco (""), el valor predeterminado es Application.

  En el ejemplo siguiente se muestra cómo se registra el componente MyApp1 como origen para el registro de aplicación. Este código supone que existe una instrucción Imports o using para el espacio de nombres System.Diagnostics:

  EventLog.CreateEventSource("MyApp1", "Application")
  

       System.Diagnostics.EventLog.CreateEventSource("MyApp1", "Application");
  

  Sugerencia:
  Para crear un origen de eventos en un equipo remoto, utilice EventSourceCreationData. El código siguiente muestra un ejemplo:

  Dim creationData As New EventSourceCreationData("ApplicationName", "Application")
  creationData.MachineName = "ServerName"
  EventLog.CreateEventSource(creationData)
  

       System.Diagnostics.EventSourceCreationData creationData = new
              System.Diagnostics.EventSourceCreationData("ApplicationName", "Application");
          creationData.MachineName = "ServerName";
          EventLog.CreateEventSource(creationData);
  

Vea también

Tareas

Cómo: Determinar si existe un origen de eventos

Cómo: Quitar un origen de eventos

Cómo: Crear y quitar registros de eventos personalizados

Tutorial: Explorar los registros de eventos, los orígenes de eventos y las entradas

Conceptos

Introducción al componente EventLog

Referencia

EventLog