Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase EventLogTraceListener

 

Publicado: octubre de 2016

Proporciona un agente de escucha simple que dirige el seguimiento o la depuración a un EventLog.

Espacio de nombres:   System.Diagnostics
Ensamblado:  System (en System.dll)

System.Object
  System.MarshalByRefObject
    System.Diagnostics.TraceListener
      System.Diagnostics.EventLogTraceListener

[HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true)]
public sealed class EventLogTraceListener : TraceListener

NombreDescripción
System_CAPS_pubmethodEventLogTraceListener()

Inicializa una nueva instancia de la EventLogTraceListener clase sin un agente de escucha de seguimiento.

System_CAPS_pubmethodEventLogTraceListener(EventLog)

Inicializa una nueva instancia de la EventLogTraceListener clase usa el registro de eventos especificado.

System_CAPS_pubmethodEventLogTraceListener(String)

Inicializa una nueva instancia de la EventLogTraceListener clase utilizando el origen especificado.

NombreDescripción
System_CAPS_pubpropertyAttributes

Obtiene los atributos de agente de escucha de seguimiento personalizados que están definidos en el archivo de configuración de la aplicación.(Heredado de TraceListener).

System_CAPS_pubpropertyEventLog

Obtiene o establece para escribir en el registro de eventos.

System_CAPS_pubpropertyFilter

Obtiene y establece el filtro de seguimiento para el agente de escucha de seguimiento.(Heredado de TraceListener).

System_CAPS_pubpropertyIndentLevel

Obtiene o establece el nivel de sangría.(Heredado de TraceListener).

System_CAPS_pubpropertyIndentSize

Obtiene o establece el número de espacios de una sangría.(Heredado de TraceListener).

System_CAPS_pubpropertyIsThreadSafe

Obtiene un valor que indica si el agente de escucha de seguimiento es seguro para la ejecución de subprocesos.(Heredado de TraceListener).

System_CAPS_pubpropertyName

Obtiene o establece el nombre de este objeto EventLogTraceListener.(Invalida TraceListener.Name).

System_CAPS_pubpropertyTraceOutputOptions

Obtiene o establece las opciones de los resultados de seguimiento.(Heredado de TraceListener).

NombreDescripción
System_CAPS_pubmethodClose()

Cierra el registro de eventos para que ya no recibe ningún resultado de seguimiento o depuración.(Invalida TraceListener.Close()).

System_CAPS_pubmethodCreateObjRef(Type)

Crea un objeto que contiene toda la información pertinente necesaria para generar a un proxy utilizado para comunicarse con un objeto remoto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodDispose()

Libera todos los recursos que usa TraceListener.(Heredado de TraceListener).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_pubmethodFail(String)

Emite un mensaje de error para el agente de escucha que se crea al implementar la clase TraceListener.(Heredado de TraceListener).

System_CAPS_pubmethodFail(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.(Heredado de TraceListener).

System_CAPS_pubmethodFlush()

Cuando se reemplaza en una clase derivada, vacía el búfer de resultados.(Heredado de TraceListener).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_protmethodGetSupportedAttributes()

Obtiene los atributos personalizados admitidos por el agente de escucha de seguimiento.(Heredado de TraceListener).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodInitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

System_CAPS_pubmethodTraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Escribe la información de seguimiento, un objeto de datos e información de evento en el registro de eventos.(Invalida TraceListener.TraceData(TraceEventCache, String, TraceEventType, Int32, Object)).

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

Escribe información de seguimiento, una matriz de objetos de datos y la información de evento en el registro de eventos.(Invalida TraceListener.TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])).

System_CAPS_pubmethodTraceEvent(TraceEventCache, String, TraceEventType, Int32)

Escribe la información de seguimiento y de evento en los resultados específicos del agente de escucha.(Heredado de TraceListener).

System_CAPS_pubmethodTraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Escribe la información, un mensaje y la información de evento en el registro de eventos de seguimiento.(Invalida TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)).

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

Escribe información de seguimiento, una matriz de objetos y la información de evento en el registro de eventos con formato.(Invalida TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])).

System_CAPS_pubmethodTraceTransfer(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.(Heredado de TraceListener).

System_CAPS_pubmethodWrite(Object)

Escribe el valor del método ToString del objeto en el agente de escucha que se crea al implementar la clase TraceListener.(Heredado de TraceListener).

System_CAPS_pubmethodWrite(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.(Heredado de TraceListener).

System_CAPS_pubmethodWrite(String)

Escribe un mensaje en el registro de eventos para esta instancia.(Invalida TraceListener.Write(String)).

System_CAPS_pubmethodWrite(String, String)

Escribe un nombre de categoría y un mensaje en el agente de escucha que se crea al implementar la clase TraceListener.(Heredado de TraceListener).

System_CAPS_pubmethodWriteLine(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.(Heredado de TraceListener).

System_CAPS_pubmethodWriteLine(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.(Heredado de TraceListener).

System_CAPS_pubmethodWriteLine(String)

Escribe un mensaje en el registro de eventos para esta instancia.(Invalida TraceListener.WriteLine(String)).

System_CAPS_pubmethodWriteLine(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.(Heredado de TraceListener).

Una instancia de este EventLogTraceListener pueden agregarse a la Debug.Listeners, Trace.Listeners, o TraceSource.Listeners colecciones para enviar los resultados del seguimiento o la depuración a un EventLog. Puede agregar la instancia en el código o especificar en el archivo de configuración de la aplicación. Para agregar una EventLogTraceListener con un archivo de configuración de la aplicación, edite el archivo que corresponde al nombre de la aplicación o el archivo app.config en un Visual Studio 2005 proyecto. En este archivo, inserte un elemento para un System.Diagnostics.EventLogTraceListener tipo.

En el ejemplo siguiente se agrega un EventLogTraceListener objeto denominado myListener a la Trace.Listeners colección. El initializeData parámetro especifica el nombre del origen de registro de eventos que se pasa a la 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 aplicación, consulte o.

System_CAPS_noteNota

Si el Source para el registro de eventos que está asociado el EventLogTraceListener instancia no existe, se crea un nuevo origen de eventos. Para crear un origen de eventos en Windows Vista, Windows XP Professional o Windows Server 2003, debe tener privilegios administrativos.

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. En Windows Vista, los usuarios no tienen permiso para tener acceso al registro de seguridad; por lo tanto, un SecurityException se produce.

En Windows Vista, el control de cuentas de usuario (UAC) determina los privilegios de un usuario. 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. De forma predeterminada, se le asignará el rol de usuario estándar. Para ejecutar el código que tiene acceso el registro de seguridad, primero debe elevar sus privilegios de usuario estándar a administrador. 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.

La clase proporciona el EventLog propiedad para obtener o establecer el registro de eventos que recibe el seguimiento o la depuración de salida, y el Name propiedad para contener el nombre de la EventLogTraceListener.

El Close método cierra el registro de eventos, por lo que ya no recibe ningún seguimiento o de depuración de salida. El Write y WriteLine métodos escriben un mensaje en el registro de eventos.

System_CAPS_noteNota

Para evitar la posibilidad de escribir grandes cantidades de datos en el registro de eventos, el EventLogTraceListener no genera los datos de seguimiento opcional especificados por el TraceOutputOptions propiedad.

En el ejemplo siguiente se crea un agente de escucha de seguimiento que envía resultados a un registro de eventos. En primer lugar, el código crea un nuevo EventLogTraceListener que utiliza el origen myEventLogSource. Después, myTraceListener se agrega a la Trace.Listeners colección. Por último, el ejemplo envía una línea de salida a la Listeners objeto.

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");
 }

.NET Framework
Disponible desde 1.1

Este tipo es seguro para la ejecución de subprocesos.

Volver al principio
Mostrar: