Arquitectura de programación de EventLog
Actualización: noviembre 2007
El componente EventLog utiliza las partes siguientes de los espacios de nombres de .NET Framework:
Espacio de nombres EventLog
.gif)
Cuando se agrega una instancia del componente EventLog a una aplicación de Visual Studio, el sistema crea automáticamente las referencias e instrucciones de importación necesarias para tener acceso al espacio de nombres y a las clases. Sin embargo, si va a crear componentes EventLog en el código o en .NET Framework de Microsoft, quizá necesite crear una referencia a System.Diagnostics y agregar una instrucción al proyecto que importe esta misma biblioteca.
Para obtener instrucciones sobre cómo agregar y eliminar referencias de proyecto, vea Cómo: Agregar o quitar referencias en Visual Studio (Visual Basic).
Elementos clave de programación en la clase EventLog
El componente EventLog provoca un evento denominado EntryWritten siempre que se escribe una entrada en el registro que se está inspeccionando. Puede definir un controlador para este evento. Además, puede utilizar los métodos siguientes para interactuar con una instancia del componente EventLog:
Puede utilizar el método Exists para determinar si existe un registro de eventos determinado.
Puede utilizar el método CreateEventSource para definir una cadena que cree una relación entre un origen de eventos y un registro, y utilizar el método DeleteEventSource para eliminar esta asociación. También puede utilizar este método para crear nuevos registros de eventos personalizados. Sólo tiene que escribir un nuevo nombre de registro para el registro en el que se desea crear el origen, y el sistema creará el registro automáticamente.
.gif "Nota")
Nota:Puede establecer la propiedad Source en cualquier cadena; no tiene que corresponder al nombre de la aplicación. Una sola aplicación puede contener múltiples componentes que utilicen diferentes cadenas de origen para identificarse a sí mismos frente a los registros de eventos.
Puede utilizar el método WriteEntry para escribir información de evento en cualquier registro de eventos al que tenga acceso. El método WriteEntry registra automáticamente el componente o la aplicación como origen válido si no está ya registrado con el registro designado.
Puede utilizar el método SourceExists para determinar si un origen concreto ya está registrado. Esto es útil cuando se intenta crear un nuevo origen en un equipo dado, puesto que el método SourceExists causará un error en tiempo de ejecución si el origen está ya registrado en ese equipo.
Puede utilizar el método GetEventLogs para recuperar una lista de todos los registros de eventos de un equipo determinado.
Puede utilizar el método Delete para eliminar un registro de eventos completo. Utilice este método con precaución, puesto que al eliminar un registro eliminará también los orígenes registrados en él.