EventLogTraceListener Clase

Definición

Proporciona un agente de escucha simple que dirige el resultado de la traza o la depuración a EventLog.Provides a simple listener that directs tracing or debugging output to an EventLog.

public ref class EventLogTraceListener sealed : System::Diagnostics::TraceListener
public sealed class EventLogTraceListener : System.Diagnostics.TraceListener
type EventLogTraceListener = class
    inherit TraceListener
Public NotInheritable Class EventLogTraceListener
Inherits TraceListener
Herencia
EventLogTraceListener

Ejemplos

En el ejemplo siguiente se crea un agente de escucha de seguimiento que envía la salida a un registro de eventos.The following example creates a trace listener that sends output to an event log. En primer lugar, el código crea EventLogTraceListener un nuevo que utiliza myEventLogSourceel origen.First, the code creates a new EventLogTraceListener that uses the source myEventLogSource. A continuación myTraceListener , se agrega a Trace.Listeners la colección.Next, myTraceListener is added to the Trace.Listeners collection. Por último, en el ejemplo se envía una línea de Listeners salida al objeto.Finally, the example sends a line of output to the Listeners object.

int main()
{
   #if defined(TRACE)
   
   // Create a trace listener for the event log.
   EventLogTraceListener^ myTraceListener = 
      gcnew EventLogTraceListener( "myEventLogSource" );
   
   // Add the event log trace listener to the collection.
   Trace::Listeners->Add( myTraceListener );
   
   // Write output to the event log.
   Trace::WriteLine( "Test output" );
   
   #endif
}
public static void Main(string[] args) {

    // Create a trace listener for the event log.
    EventLogTraceListener myTraceListener = new EventLogTraceListener("myEventLogSource");
 
    // Add the event log trace listener to the collection.
    Trace.Listeners.Add(myTraceListener);
 
    // Write output to the event log.
    Trace.WriteLine("Test output");
 }
 
Overloads Public Shared Sub Main(args() As String)
   
    ' Create a trace listener for the event log.
    Dim myTraceListener As New EventLogTraceListener("myEventLogSource")
    
    ' Add the event log trace listener to the collection.
    Trace.Listeners.Add(myTraceListener)
    
    ' Write output to the event log.
    Trace.WriteLine("Test output")
End Sub

Comentarios

Se EventLogTraceListener puede Agregar una instancia de a las TraceSource.Listeners Debug.Listeners Trace.Listenerscolecciones, o para enviar la salida de la traza o la depuración a. EventLogAn instance of this EventLogTraceListener can be added to the Debug.Listeners, Trace.Listeners, or TraceSource.Listeners collections to send output from tracing or debugging to an EventLog. Puede Agregar la instancia en el código o especificarla en el archivo de configuración de la aplicación.You can add the instance in your code or specify it in the application configuration file. Para agregar una EventLogTraceListener mediante un archivo de configuración de la aplicación, edite el archivo que corresponde al nombre de la aplicación o el archivo app. Visual Studio 2005Visual Studio 2005 config en un proyecto.To add an EventLogTraceListener using an application configuration file, edit the file that corresponds to the name of your application or the app.config file in a Visual Studio 2005Visual Studio 2005 project. En este archivo, inserte un elemento para un System.Diagnostics.EventLogTraceListener tipo.In this file, insert an element for a System.Diagnostics.EventLogTraceListener type.

En el ejemplo siguiente se EventLogTraceListener agrega un myListener objeto denominado Trace.Listeners a la colección.The following example adds a EventLogTraceListener object named myListener to the Trace.Listeners collection. El initializeData parámetro especifica el nombre del origen del registro de eventos que se va a pasar EventLogTraceListener(String) al constructor.The initializeData parameter specifies the name of the event log source that is to be passed to the EventLogTraceListener(String) constructor.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="myListener"  
          type="System.Diagnostics.EventLogTraceListener"  
          initializeData="TraceListenerLog" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Para obtener más información sobre cómo agregar agentes de escucha de seguimiento en el archivo de configuración de la aplicación, vea o.For more information about how to add trace listeners in the application configuration file, see or .

Nota

Si el Source del registro de eventos asociado a la EventLogTraceListener instancia no existe, se crea un nuevo origen de eventos.If the Source for the event log that is associated with the EventLogTraceListener instance does not exist, a new event source is created. Para crear un origen de eventos en Windows Vista, Windows XP Professional o Windows Server 2003, debe tener privilegios administrativos.To create an event source in Windows Vista, Windows XP Professional, or Windows Server 2003, you must have administrative privileges.

El motivo de este requisito es que se deben buscar todos los registros de eventos, incluida la seguridad, para determinar si el origen del evento es único.The reason for this requirement is that all event logs, including security, must be searched to determine whether the event source is unique. En Windows Vista, los usuarios no tienen permiso para obtener acceso al registro de seguridad. por lo tanto SecurityException , se produce una excepción.In Windows Vista, users do not have permission to access the security log; therefore, a SecurityException is thrown.

En Windows Vista, el control de cuentas de usuario (UAC) determina los privilegios de un usuario.In Windows Vista, User Account Control (UAC) determines the privileges of a user. Si es miembro del grupo Administradores integrados, se le asignarán dos símbolos (tokens) de acceso en tiempo de ejecución: un símbolo (token) de acceso de usuario estándar y un símbolo (token) de acceso de administrador.If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. De forma predeterminada, se le asignará el rol de usuario estándar.By default, you are in the standard user role. Para ejecutar el código que tiene acceso al registro de seguridad, primero debe elevar los privilegios de usuario estándar a administrador.To execute the code that accesses the security log, you must first elevate your privileges from standard user to administrator. Para ello, inicie una aplicación haciendo clic con el botón derecho en el icono de la aplicación e indique que desea ejecutarla como administrador.You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator.

La clase proporciona la EventLog propiedad para obtener o establecer el registro de eventos que recibe los resultados de la traza o de la Name depuración, y la propiedad EventLogTraceListenerpara contener el nombre de.The class provides the EventLog property to get or set the event log that receives the tracing or debugging output, and the Name property to hold the name of the EventLogTraceListener.

El Close método cierra el registro de eventos para que ya no reciba resultados de la traza o de la depuración.The Close method closes the event log so it no longer receives tracing or debugging output. Los Write métodos WriteLine y escriben un mensaje en el registro de eventos.The Write and WriteLine methods write a message to the event log.

Nota

Para evitar la posibilidad de escribir grandes cantidades de datos en el registro de eventos, EventLogTraceListener no genera los datos de seguimiento opcionales especificados por TraceOutputOptions la propiedad.To avoid the possibility of writing large amounts of data to the event log, the EventLogTraceListener does not output the optional trace data specified by the TraceOutputOptions property.

Constructores

EventLogTraceListener()

Inicializa una nueva instancia de la clase EventLogTraceListener sin un agente de escucha de seguimiento.Initializes a new instance of the EventLogTraceListener class without a trace listener.

EventLogTraceListener(EventLog)

Inicializa una nueva instancia de la clase EventLogTraceListener utilizando el registro de eventos especificado.Initializes a new instance of the EventLogTraceListener class using the specified event log.

EventLogTraceListener(String)

Inicializa una nueva instancia de la clase EventLogTraceListener utilizando el origen especificado.Initializes a new instance of the EventLogTraceListener class using the specified source.

Propiedades

Attributes

Obtiene los atributos de agente de escucha de seguimiento personalizados que están definidos en el archivo de configuración de la aplicación.Gets the custom trace listener attributes defined in the application configuration file.

(Heredado de TraceListener)
EventLog

Obtiene o establece el registro de eventos donde se va a escribir.Gets or sets the event log to write to.

Filter

Obtiene o establece el filtro de seguimiento para el agente de escucha de seguimiento.Gets or sets the trace filter for the trace listener.

(Heredado de TraceListener)
IndentLevel

Obtiene o establece el nivel de sangría.Gets or sets the indent level.

(Heredado de TraceListener)
IndentSize

Obtiene o establece el número de espacios de una sangría.Gets or sets the number of spaces in an indent.

(Heredado de TraceListener)
IsThreadSafe

Obtiene un valor que indica si el agente de escucha de seguimiento es seguro para la ejecución de subprocesos.Gets a value indicating whether the trace listener is thread safe.

(Heredado de TraceListener)
Name

Obtiene o establece el nombre de este objeto EventLogTraceListener.Gets or sets the name of this EventLogTraceListener.

NeedIndent

Obtiene o establece un valor que indica si se va a aplicar sangría a los resultados.Gets or sets a value indicating whether to indent the output.

(Heredado de TraceListener)
TraceOutputOptions

Obtiene o establece las opciones de los resultados de seguimiento.Gets or sets the trace output options.

(Heredado de TraceListener)

Métodos

Close()

Cierra el registro de eventos de forma que dejan de recibirse los resultados de la traza o la depuración.Closes the event log so that it no longer receives tracing or debugging output.

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos que usa TraceListener.Releases all resources used by the TraceListener.

(Heredado de TraceListener)
Dispose(Boolean)

Libera los recursos no administrados que usa TraceListener y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the TraceListener and optionally releases the managed resources.

(Heredado de TraceListener)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
Fail(String)

Emite un mensaje de error para el agente de escucha que se crea al implementar la clase TraceListener.Emits an error message to the listener you create when you implement the TraceListener class.

(Heredado de TraceListener)
Fail(String, String)

Emite un mensaje de error y un mensaje de error detallado para el agente de escucha que se crea al implementar la clase TraceListener.Emits an error message and a detailed error message to the listener you create when you implement the TraceListener class.

(Heredado de TraceListener)
Flush()

Cuando se reemplaza en una clase derivada, vacía el búfer de resultados.When overridden in a derived class, flushes the output buffer.

(Heredado de TraceListener)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetSupportedAttributes()

Obtiene los atributos personalizados admitidos por el agente de escucha de seguimiento.Gets the custom attributes supported by the trace listener.

(Heredado de TraceListener)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Escribe la información de seguimiento, un objeto de datos y la información de evento en el registro de eventos.Writes trace information, a data object, and event information to the event log.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Escribe la información de seguimiento, una matriz de objetos de datos y la información de evento en el registro de eventos.Writes trace information, an array of data objects, and event information to the event log.

TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Escribe la información de seguimiento y de evento en los resultados específicos del agente de escucha.Writes trace and event information to the listener specific output.

(Heredado de TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Escribe la información de seguimiento, un mensaje y la información de evento en el registro de eventos.Writes trace information, a message, and event information to the event log.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Escribe la información de seguimiento, una matriz de objetos con formato y la información de evento en el registro de eventos.Writes trace information, a formatted array of objects, and event information to the event log.

TraceTransfer(TraceEventCache, String, Int32, String, Guid)

Escribe la información de seguimiento, un mensaje, una identidad de actividad relacionada y la información de evento en los resultados específicos del agente de escucha.Writes trace information, a message, a related activity identity and event information to the listener specific output.

(Heredado de TraceListener)
Write(Object)

Escribe el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(Heredado de TraceListener)
Write(Object, String)

Escribe un nombre de categoría y el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(Heredado de TraceListener)
Write(String)

Escribe un mensaje en el registro de eventos para esta instancia.Writes a message to the event log for this instance.

Write(String, String)

Escribe un nombre de categoría y un mensaje en el agente de escucha que se crea al implementar la clase TraceListener.Writes a category name and a message to the listener you create when you implement the TraceListener class.

(Heredado de TraceListener)
WriteIndent()

Escribe la sangría en el agente de escucha que se crea al implementar esta clase y restablece la propiedad NeedIndent en false.Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to false.

(Heredado de TraceListener)
WriteLine(Object)

Escribe el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener, seguido de un terminador de línea.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Heredado de TraceListener)
WriteLine(Object, String)

Escribe un nombre de categoría y el valor del método ToString() del objeto en el agente de escucha que se crea al implementar la clase TraceListener, seguidos de un terminador de línea.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Heredado de TraceListener)
WriteLine(String)

Escribe un mensaje en el registro de eventos para esta instancia.Writes a message to the event log for this instance.

WriteLine(String, String)

Escribe un nombre de categoría y un mensaje en el agente de escucha que se crea al implementar la clase TraceListener, seguidos de un terminador de línea.Writes a category name and a message to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Heredado de TraceListener)

Se aplica a

Seguridad para subprocesos

Este tipo es seguro para la ejecución de subprocesos.This type is thread safe.

Consulte también: