Cómo: Configurar instancias de componentes EventLog
Actualización: noviembre 2007
Hay tres propiedades principales implicadas en la configuración de una instancia del componente EventLog:
La propiedad Log, que indica el registro con el que se desea interactuar.
La propiedad MachineName, que indica el equipo en el que reside el registro con el que se está trabajando.
La propiedad Source, que indica la cadena de origen que se utilizará para identificar el componente cuando se escriban entradas en un registro.
La forma de configurar el componente EventLog depende de cómo se vaya a utilizar:
Si pretende escribir entradas en un registro, debe realizar una de las dos opciones. Deberá registrar un origen utilizando el método CreateEventSource y establecer la propiedad Source del componente EventLog en ese mismo origen, o deberá establecer las propiedades MachineName, Log y Source del componente.
Nota: Puede establecer directamente la propiedad Log del componente o definirla en el código de forma que registre el componente como un origen de eventos. Después de registrar el componente como origen, se habrá establecido ya una conexión en el Registro del servidor que vinculará el componente a un registro específico.
Si pretende leer entradas del registro o supervisar un registro, deberá establecer las propiedades MachineName y Log para indicar el registro que está inspeccionando. En este caso, no será necesario que establezca la propiedad Source.
Si desea que el componente pueda recibir notificaciones de los eventos EntryWritten, debe establecer la propiedad EnableRaisingEvents en true. Para obtener más información, vea Cómo: Controlar el evento EntryWritten.
El ejemplo siguiente muestra cómo configurar el componente para que permita escribir entradas en el registro de aplicación. En este caso, el origen aún no se ha registrado con el registro, así que deberá especificar la cadena de origen, el registro y el nombre del equipo. No es necesario llamar de forma explícita al método CreateEventSource, puesto que al llamar a WriteEntry, se registrará el origen con el registro si aún no se ha hecho.
Dim EventLog1 As New EventLog("Application", "myserver", "newsource") EventLog1.WriteEntry("Test")
System.Diagnostics.EventLog EventLog1 = new System.Diagnostics.EventLog("Application", "myserver", "newsource"); EventLog1.WriteEntry("Test");
Si el origen ya está registrado, puede establecer simplemente la propiedad Source y escribir la entrada. Por ejemplo, el código siguiente muestra cómo escribir una entrada en un registro utilizando un origen ya registrado.
If Not EventLog.SourceExists("ExistingSourceString") Then EventLog.CreateEventSource("ExistingSourceString", "Application") End If Dim EventLog1 As New EventLog() EventLog1.Source = "ExistingSourceString" EventLog1.WriteEntry("TestEntry2")
if (!System.Diagnostics.EventLog.SourceExists("ExistingSourceString")) System.Diagnostics.EventLog.CreateEventSource( "ExistingSourceString", "Application"); System.Diagnostics.EventLog EventLog1 = new System.Diagnostics.EventLog(); EventLog1.Source = "ExistingSourceString"; EventLog1.WriteEntry("TestEntry2");
Nota: Si no define la propiedad MachineName, como se muestra en estos ejemplos, se asume que se trata del equipo local.
Para obtener más información sobre estas propiedades, vea Referencias del registro de eventos.
Las entradas que se recuperan de un registro de eventos se clasifican por categorías según múltiples propiedades. Para obtener más información sobre estas propiedades, vea EventLog.
Para configurar una instancia del componente EventLog
Cree una instancia del componente EventLog. Para obtener más información, vea Cómo: Crear instancias de componentes EventLog.
Establezca la combinación adecuada de propiedades Log, MachineName y Source:
Si va a
Haga lo siguiente
Leer o supervisar registros de eventos
Establecer las propiedades Log y MachineName
Escribir entradas en un registro utilizando una nueva cadena Source
Establecer las propiedades Source, Log y MachineName
Escribir entradas en un registro en una cadena Source existente
Establecer la propiedad Source en el origen existente; las otras propiedades se definirán automáticamente.
Para que la instancia del componente pueda recibir notificaciones del evento EntryWritten, establezca la propiedad EnableRaisingEvents en true.
Vea también
Tareas
Cómo: Crear instancias de componentes EventLog
Cómo: Agregar una aplicación como origen de entradas de un registro de eventos
Cómo: Escribir entradas en los registros de eventos