EventSchemaTraceListener Clase
TOC
Collapse the table of content
Expand the table of content
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

EventSchemaTraceListener (Clase)

 

Dirige los resultados de seguimiento o de depuración de eventos de un extremo a otro a un archivo de registro con codificación XML conforme al esquema.

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

System.Object
  System.MarshalByRefObject
    System.Diagnostics.TraceListener
      System.Diagnostics.TextWriterTraceListener
        System.Diagnostics.EventSchemaTraceListener

[HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true)]
[HostProtectionAttribute(SecurityAction.LinkDemand, MayLeakOnAbort = true)]
public class EventSchemaTraceListener : TextWriterTraceListener

NombreDescripción
System_CAPS_pubmethodEventSchemaTraceListener(String)

Inicializa una nueva instancia de la clase EventSchemaTraceListener y usa el archivo especificado como destinatario de los resultados de seguimiento o de depuración.

System_CAPS_pubmethodEventSchemaTraceListener(String, String)

Inicializa una nueva instancia de la clase EventSchemaTraceListener con el nombre especificado y usa el archivo especificado como destinatario de los resultados de seguimiento o de depuración.

System_CAPS_pubmethodEventSchemaTraceListener(String, String, Int32)

Inicializa una nueva instancia de la clase EventSchemaTraceListener con el nombre especificado y el tamaño de búfer especificado, y usa el archivo especificado como destinatario de los resultados de seguimiento o de depuración.

System_CAPS_pubmethodEventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption)

Inicializa una nueva instancia de la clase EventSchemaTraceListener con el nombre especificado y el tamaño de búfer especificado, y usa el archivo especificado, con la directiva de retención de registro especificada, como destinatario de los resultados de seguimiento o de depuración.

System_CAPS_pubmethodEventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64)

Inicializa una nueva instancia de la clase EventSchemaTraceListener con el nombre especificado y el tamaño de búfer especificado, y usa el archivo especificado, con la directiva de retención de registro especificada y el tamaño máximo, como destinatario de los resultados de seguimiento o de depuración.

System_CAPS_pubmethodEventSchemaTraceListener(String, String, Int32, TraceLogRetentionOption, Int64, Int32)

Inicializa una nueva instancia de la clase EventSchemaTraceListener con el nombre especificado y el tamaño de búfer especificado, y usa el archivo especificado, con la directiva de retención de registro especificada, el tamaño máximo y el recuento de archivos, como destinatario de los resultados de seguimiento o de depuración.

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_pubpropertyBufferSize

Obtiene el tamaño del búfer de salida.

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.(Reemplaza a TraceListener.IsThreadSafe).

System_CAPS_pubpropertyMaximumFileSize

Obtiene el tamaño máximo del archivo de registro.

System_CAPS_pubpropertyMaximumNumberOfFiles

Obtiene el número máximo de archivos de registro.

System_CAPS_pubpropertyName

Obtiene o establece un nombre para este objeto TraceListener.(Heredado de TraceListener.)

System_CAPS_protpropertyNeedIndent

Obtiene o establece un valor que indica si se va a aplicar sangría a los resultados.(Heredado de TraceListener.)

System_CAPS_pubpropertyTraceLogRetentionOption

Obtiene la opción de retención de registro del seguimiento para el archivo.

System_CAPS_pubpropertyTraceOutputOptions

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

System_CAPS_pubpropertyWriter

Obtiene o establece el escritor de texto subyacente que escribe en el archivo de registro.

NombreDescripción
System_CAPS_pubmethodClose()

Cierra el archivo de registro para este agente de escucha, de modo que ya no recibe ningún resultado de seguimiento o de depuración.(Reemplaza a TextWriterTraceListener.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 usados por TraceListener.(Heredado de TraceListener.)

System_CAPS_protmethodDispose(Boolean)

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Elimina esta TextWriterTraceListener objeto.(Heredado de TextWriterTraceListener.)

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)

Escribe la información de error, que incluye un mensaje de error básico y un mensaje de error detallado, en el archivo de registro.(Reemplaza a TraceListener.Fail(String, String)).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object.)

System_CAPS_pubmethodFlush()

Hace que los datos almacenados en el búfer se escriban en el registro para este agente de escucha.(Reemplaza a TextWriterTraceListener.Flush()).

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 de configuración XML personalizados que admite el agente de escucha de seguimiento.(Reemplaza a TraceListener.GetSupportedAttributes()).

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_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficial del actual MarshalByRefObject objeto.(Heredado de MarshalByRefObject.)

System_CAPS_pubmethodToString()

Retorna 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 solo objeto de datos y la información de los eventos en el archivo de registro.(Reemplaza a TraceListener.TraceData(TraceEventCache, String, TraceEventType, Int32, Object)).

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

Escribe la información de seguimiento, varios objetos de datos y la información de los eventos en el archivo de registro.(Reemplaza a 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 de seguimiento, un mensaje y la información de los eventos en el archivo de registro.(Reemplaza a TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)).

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

Escribe la información del seguimiento, un mensaje con formato y la información de los eventos en el archivo de registro.(Reemplaza a TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])).

System_CAPS_pubmethodTraceTransfer(TraceEventCache, String, Int32, String, Guid)

Escribe la información de seguimiento (incluida la identidad de una actividad relacionada), un mensaje y la información de eventos en el archivo de registro.(Reemplaza a TraceListener.TraceTransfer(TraceEventCache, String, Int32, String, Guid)).

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 archivo de registro sin proporcionar ninguna información de contexto adicional.(Reemplaza a TextWriterTraceListener.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_protmethodWriteIndent()

Escribe la sangría en el agente de escucha que se crea al implementar esta clase y restablece la propiedad NeedIndent en false.(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 seguido del terminador de línea actual del archivo de registro sin proporcionar información de contexto adicional.(Reemplaza a TextWriterTraceListener.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.)

La EventSchemaTraceListener clase proporciona la traza de eventos conformes al esquema de extremo a extremo. Puede utilizar el seguimiento de extremo a extremo para un sistema con componentes heterogéneos que atraviesan el subproceso, AppDomain, proceso y los límites del equipo. Un esquema de eventos normalizado (vea Event Representation for Event Consumers) se ha definido para habilitar el seguimiento de estos límites. El esquema permite la adición de elementos personalizados, conformes al esquema. Puede usar el Service Trace Viewer Tool (SvcTraceViewer.exe) para mostrar los datos del evento.

EventSchemaTraceListener se ajusta para el registro de rendimiento con compatibilidad implícita traza sin bloqueo.

La EventSchemaTraceListener clase convierte la información en una secuencia de texto codificado en XML de depuración y seguimiento. La descripción del resultado XML se muestra en las tablas más adelante en esta sección.

Puede habilitar o deshabilitar un EventSchemaTraceListener a través del archivo de configuración de aplicación y, a continuación, utilice configurado EventSchemaTraceListener objeto de la aplicación. Como alternativa, puede crear un EventSchemaTraceListener objeto en el código. Se recomienda que habilite los agentes de escucha de seguimiento a través del archivo de configuración de aplicación. Para obtener información sobre el uso de archivos de configuración de seguimiento y depuración, consulte Esquema de la configuración de seguimiento y depuración.

Para configurar una EventSchemaTraceListener de objeto, modifique el archivo de configuración que corresponde al nombre de la aplicación. En este archivo, puede agregar, quitar o establecer las propiedades de un agente de escucha. El archivo de configuración debería tener el siguiente formato:

<configuration>
    <system.diagnostics>
        <sources>
            <source name="TestSource" >
                <listeners>
                    <!--Remove the default trace listener for better performance.-->
                    <remove name="Default"/>
                    <!--Note: Removing the default trace listener prevents the dialog box 
                    from being displayed for Debug.Fail or Debug.Assert commands that are 
                    executed in user mode.-->
                    <add name="eventListener" 
                      type="System.Diagnostics.EventSchemaTraceListener,  system.core"
                      initializeData="TraceOutput.xml" 
                      traceOutputOptions="ProcessId, DateTime, Timestamp" 
                      bufferSize="65536"
                      maximumFileSize="20480000"
                      logRetentionOption="LimitedCircularFiles"
                      maximumNumberOfFiles="2"/>
                </listeners>
            </source>
        </sources>
    </system.diagnostics>

La EventSchemaTraceListener clase hereda el Filter propiedad de la clase base TraceListener. El Filter propiedad permite un nivel adicional de filtrado en el agente de escucha de resultados de seguimiento. Si un filtro está presente, el Trace métodos de la llamada al agente de escucha de seguimiento el ShouldTrace método del filtro para determinar si se debe emitir el seguimiento.

Si se intenta escribir en un archivo que se está usando o no está disponible, se agrega automáticamente un sufijo GUID al nombre de archivo.

System_CAPS_noteNota

Métodos de agente de escucha están pensados para ser llamado por métodos de la Debug, Trace, y TraceSource las clases. No llame a estos métodos directamente desde el código de la aplicación. La EventSchemaTraceListener agente de escucha está pensado principalmente para su uso por el TraceSource clase.

La tabla siguiente describen los elementos y atributos de los resultados XML.

Elemento

Atributos

Salida

Notas

CallStack

NONE

Depende de la presencia de la Callstack marca en el TraceOutputOptions propiedad.

Caracteres especiales como > o < se reemplazan con secuencias de escape. Consulte la tabla de traducción de caracteres de escape en la tabla siguiente.

Computer

NONE

Siempre está presente.

Este elemento representa el valor de la MachineName propiedad.

Correlation

ActivityID

Siempre está presente.

Si ActivityID no se especifica, el valor predeterminado es un GUID vacío.

RelatedActivityID

Depende de la presencia de la relatedActivityId parámetro en el Trace llamada al método.

El RelatedActivityID atributo corresponde a la relatedActivityId parámetro de la TraceTransfer (método).

Data

NONE

Siempre está presente.

Este elemento representa la entrada del parámetro (data). Un elemento se proporciona para cada objeto de datos. En el caso de los registros de eventos, el Data elemento contiene datos XML de escape. En el caso de registros de datos, la Data elemento contiene datos sin escape. Los datos de registro salida utiliza la ToString método de los objetos de datos en el pasado.

Event

NONE

Siempre está presente.

Este elemento contiene un evento de seguimiento.

EventData

NONE

Presente para los registros de eventos.

Este elemento representa la entrada del parámetro (message, args). Contiene Data elementos con datos XML de escape que se crean mediante una llamada a la TraceEvent (método).

EventID

NONE

Siempre está presente.

Este elemento representa la entrada del parámetro (id).

Execution

ProcessID

Depende de la presencia de la ProcessId marca en el TraceOutputOptions propiedad.

El ProcessID se especifica el atributo en el TraceEventCache. En el Microsoft Windows 98 y Windows Millennium Edition los sistemas operativos, si ProcessID es mayor que 2.147.483.647, es una representación positiva de un número negativo y debe convertirse para obtener el identificador de proceso correcto.

ThreadID

Presentar cuando ProcessID está presente.

El ThreadID se especifica el atributo en el TraceEventCache.

Level

NONE

Siempre está presente.

Este elemento representa la entrada del parámetro (el valor numérico de eventType). Los valores de parámetro mayores que 255 salen como un nivel 8, que representa TraceEventType.Information. Tipos de evento de seguimiento Critical, Error, Warning, Information, y Verbose son la salida como niveles 1, 2, 4, 8 y 10, respectivamente.

LogicalOperationStack

NONE

Depende de la presencia de la LogicalOperationStack marca en el TraceOutputOptions propiedad.

Puede existir una única operación lógica. Por lo tanto, los valores se escriben como LogicalOperation nodos bajo el LogicalOperationStack elemento.

OpCode

NONE

Presentar cuando Level es mayor de 255.

Este elemento representa tipos de evento de seguimiento que tienen valores numéricos mayores que 255. Start, Stop, Suspend, Resume, o Transfer son la salida como niveles 1, 2, 4, 8 y 10, respectivamente.

Provider

GUID

Siempre está presente.

Siempre está vacío.

RenderingInfo

Culture

Siempre está presente.

Este atributo representa una cadena de recurso para el tipo de evento. Siempre es "en EN\".

System

Name

Siempre está presente.

TimeCreated

SystemTime

Depende de la presencia de la DateTime marca en el TraceOutputOptions propiedad.

La hora es el valor de la TraceEventCache.DateTime propiedad. Esta propiedad se expresa como hora Universal coordinada

TimeStamp

NONE

Depende de la presencia de la Timestamp marca en el TraceOutputOptions propiedad.

Este elemento se especifica en el TraceEventCache.

UserData

NONE

Presente para los registros de datos.

Este elemento contiene Data elementos con datos sin escape, proporcionado por el usuario desde un TraceData (método).

La siguiente tabla muestra los caracteres de escape en los resultados XML. Secuencia de escape se produce en todos los elementos y los atributos excepto el UserData elemento, que contiene proporcionado por el usuario, sin escape datos. El UserData elemento es el resultado de las llamadas a la TraceData (método).

Carácter de escape

Valor

&

&amp;

<

&lt;

>

&gt;

"

&quot;

\

&apos;

0xD

& #xD;

0xA

& #xA;

En el ejemplo de código siguiente se muestra cómo utilizar el EventSchemaTraceListener clase.

#define NOCONFIGFILE
using System;
using System.IO;
using System.Xml;
using System.Xml.XPath;
using System.Diagnostics;

class testClass
{
    [STAThreadAttribute]
    static void Main()
    {
        File.Delete("TraceOutput.xml");
        TraceSource ts = new TraceSource("TestSource");
#if NOCONFIGFILE
        //ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener", 65536, TraceLogRetentionOption.LimitedCircularFiles, 20480000, 2));
        ts.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml", "eventListener"));
        ts.Listeners["eventListener"].TraceOutputOptions = TraceOptions.DateTime | TraceOptions.ProcessId | TraceOptions.Timestamp;
#endif
        ts.Switch.Level = SourceLevels.All;
        string testString = "<Test><InnerElement Val=\"1\" /><InnerElement Val=\"Data\"/><AnotherElement>11</AnotherElement></Test>";
        UnescapedXmlDiagnosticData unXData = new UnescapedXmlDiagnosticData(testString);
        ts.TraceData(TraceEventType.Error, 38, unXData);
        ts.TraceEvent(TraceEventType.Error, 38, testString);
        Trace.Listeners.Add(new EventSchemaTraceListener("TraceOutput.xml"));
        Trace.Write("test", "test");
        Trace.Flush();
        ts.Flush();
        ts.Close();
        DisplayProperties(ts);
        Process.Start("notepad.exe", "TraceOutput.xml");
        Console.WriteLine("Press the enter key to exit");
        Console.ReadLine();
    }
    private static void DisplayProperties(TraceSource ts)
    {
        Console.WriteLine("IsThreadSafe? " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).IsThreadSafe);
        Console.WriteLine("BufferSize =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).BufferSize);
        Console.WriteLine("MaximumFileSize =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).MaximumFileSize);
        Console.WriteLine("MaximumNumberOfFiles =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).MaximumNumberOfFiles);
        Console.WriteLine("Name =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).Name);
        Console.WriteLine("TraceLogRetentionOption =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).TraceLogRetentionOption);
        Console.WriteLine("TraceOutputOptions =  " + ((EventSchemaTraceListener)ts.Listeners["eventListener"]).TraceOutputOptions);
    }
}

.NET Framework
Disponible desde 3.5

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Volver al principio
Mostrar:
© 2016 Microsoft