Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

EventLogTraceListener (Clase)

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

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

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

'Declaración
<HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization := True)> _
Public NotInheritable Class EventLogTraceListener _
	Inherits TraceListener

El tipo EventLogTraceListener expone los siguientes miembros.

  NombreDescripción
Método públicoEventLogTraceListenerInicializa una nueva instancia de la clase EventLogTraceListener sin un agente de escucha de seguimiento.
Método públicoEventLogTraceListener(EventLog)Inicializa una nueva instancia de la clase EventLogTraceListener utilizando el registro de eventos especificado.
Método públicoEventLogTraceListener(String)Inicializa una nueva instancia de la clase EventLogTraceListener utilizando el origen especificado.
Arriba

  NombreDescripción
Propiedad públicaAttributesObtiene los atributos de agente de escucha de seguimiento personalizados que están definidos en el archivo de configuración de la aplicación. (Se hereda de TraceListener).
Propiedad públicaEventLogObtiene o establece el registro de eventos donde se va a escribir.
Propiedad públicaFilterObtiene y establece el filtro de seguimiento para el agente de escucha de seguimiento. (Se hereda de TraceListener).
Propiedad públicaIndentLevelObtiene o establece el nivel de sangría. (Se hereda de TraceListener).
Propiedad públicaIndentSizeObtiene o establece el número de espacios de una sangría. (Se hereda de TraceListener).
Propiedad públicaIsThreadSafeObtiene un valor que indica si el agente de escucha de seguimiento es seguro para la ejecución de subprocesos. (Se hereda de TraceListener).
Propiedad públicaNameObtiene o establece el nombre de este objeto EventLogTraceListener. (Invalida a TraceListener.Name).
Propiedad públicaTraceOutputOptionsObtiene o establece las opciones de los resultados de seguimiento. (Se hereda de TraceListener).
Arriba

  NombreDescripción
Método públicoCloseCierra el registro de eventos de forma que dejan de recibirse los resultados de la traza o la depuración. (Invalida a TraceListener.Close).
Método públicoCreateObjRefCrea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método públicoDisposeLibera todos los recursos utilizados por TraceListener. (Se hereda de TraceListener).
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método públicoFail(String)Emite un mensaje de error para el agente de escucha que se crea al implementar la clase TraceListener. (Se hereda de TraceListener).
Método públicoFail(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. (Se hereda de TraceListener).
Método públicoFlushCuando se reemplaza en una clase derivada, vacía el búfer de resultados. (Se hereda de TraceListener).
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetLifetimeServiceRecupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoGetSupportedAttributesObtiene los atributos personalizados admitidos por el agente de escucha de seguimiento. (Se hereda de TraceListener).
Método públicoGetType Obtiene el Typede la instancia actual. (Se hereda de Object).
Método públicoInitializeLifetimeServiceObtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoTraceData(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. (Invalida a TraceListener.TraceData(TraceEventCache, String, TraceEventType, Int32, Object)).
Método públicoTraceData(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. (Invalida a TraceListener.TraceData(TraceEventCache, String, TraceEventType, Int32, Object())).
Método públicoTraceEvent(TraceEventCache, String, TraceEventType, Int32)Escribe la información de seguimiento y de evento en los resultados específicos del agente de escucha. (Se hereda de TraceListener).
Método públicoTraceEvent(TraceEventCache, String, TraceEventType, Int32, String)Escribe la información de seguimiento, un mensaje y la información de evento en el registro de eventos. (Invalida a TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)).
Método públicoTraceEvent(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. (Invalida a TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object())).
Método públicoTraceTransferEscribe 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. (Se hereda de TraceListener).
Método públicoWrite(Object)Escribe el valor del método ToString del objeto en el agente de escucha que se crea al implementar la clase TraceListener. (Se hereda de TraceListener).
Método públicoWrite(String)Escribe un mensaje en el registro de eventos para esta instancia. (Invalida a TraceListener.Write(String)).
Método públicoWrite(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. (Se hereda de TraceListener).
Método públicoWrite(String, String)Escribe un nombre de categoría y un mensaje en el agente de escucha que se crea al implementar la clase TraceListener. (Se hereda de TraceListener).
Método públicoWriteLine(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. (Se hereda de TraceListener).
Método públicoWriteLine(String)Escribe un mensaje en el registro de eventos para esta instancia. (Invalida a TraceListener.WriteLine(String)).
Método públicoWriteLine(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. (Se hereda de TraceListener).
Método públicoWriteLine(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. (Se hereda de TraceListener).
Arriba

Se puede agregar una instancia de EventLogTraceListener a las colecciones Debug.Listeners, Trace.Listeners o TraceSource.Listeners para enviar los resultados de la traza o la depuración a EventLog. Puede agregar la instancia en su código o especificarlo en el archivo de configuración de la aplicación. Para agregar EventLogTraceListener mediante un archivo de configuración de la aplicación, modifique el archivo que corresponde al nombre de su aplicación o el archivo app.config en un proyecto Visual Studio 2005. En este archivo, inserte un elemento para un tipo System.Diagnostics.EventLogTraceListener.

En el ejemplo siguiente se agrega un objeto EventLogTraceListener denominado myListener a la colección Trace.Listeners. El parámetro initializeData especifica el nombre del origen del registro de eventos que se pasará al constructor EventLogTraceListener(String).

<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 los agentes de escucha de seguimiento en el archivo de configuración de la aplicación, vea Elemento <listeners> o Elemento <listeners> para <source>.

NotaNota

Si el Source del registro de eventos asociado a la instancia EventLogTraceListener 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 de administrador.

La razón de este requisito es que deben buscarse todos los registros de eventos, incluidos los de seguridad, para determinar si el origen del evento es único. En Windows Vista, los usuarios no tienen permiso de acceso al registro de seguridad; por consiguiente, se produce SecurityException .

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 al registro de seguridad, primero debe elevar el nivel de sus privilegios de usuario estándar a administrador. Podrá hacerlo cuando inicie una aplicación haciendo clic con el botón secundario en el icono de la aplicación e indicando que desea ejecutarla como administrador.

La clase proporciona la propiedad EventLog para obtener o establecer el registro de eventos que recibe los resultados de la traza o la depuración y la propiedad Name para incluir el nombre de EventLogTraceListener.

El método Close cierra el registro de eventos para que deje de recibir resultados de la traza o la depuración. Los métodos Write y WriteLine escriben un mensaje en el registro de eventos.

NotaNota

Para evitar que se escriban grandes cantidades de datos en el registro de eventos, EventLogTraceListener no escribe la información de seguimiento opcional especificada por la propiedad TraceOutputOptions.

NotaNota

El atributo HostProtectionAttribute aplicado a este tipo o miembro tiene el siguiente valor de propiedad Resources: Synchronization. El atributo HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician haciendo doble clic en un icono, escribiendo un comando o introduciendo una dirección URL en el explorador). Para obtener más información, vea la clase HostProtectionAttribute o Programación en SQL Server y atributos de protección de host.

En el siguiente ejemplo 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 myEventLogSource de origen. A continuación, myTraceListener se agrega a la colección de Trace.Listeners. Finalmente, el ejemplo envía una línea de resultados al objeto Listeners.


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 'Main


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft