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 EventSchemaTraceListener

 

Publicado: octubre de 2016

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)>]
type EventSchemaTraceListener = 
    class
        inherit TextWriterTraceListener
    end

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.(Invalida 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.(Invalida TextWriterTraceListener.Close()).

System_CAPS_pubmethodCreateObjRef(Type)

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

System_CAPS_pubmethodDispose()

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

System_CAPS_protmethodDispose(Boolean)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el 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.(Invalida 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.(Invalida 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.(Invalida 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 elemento actual MarshalByRefObject objeto.(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 solo objeto de datos y la información de los eventos en el archivo de registro.(Invalida 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.(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 de seguimiento, un mensaje y la información de los eventos en el archivo de registro.(Invalida 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.(Invalida 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.(Invalida 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.(Invalida 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.(Invalida 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).

The T:System.Diagnostics.EventSchemaTraceListener class provides tracing of end-to-end schema-compliant events. You can use end-to-end tracing for a system that has heterogeneous components that cross thread, T:System.AppDomain, process, and computer boundaries. A standardized event schema (see Event Representation for Event Consumershttp://go.microsoft.com/fwlink/?LinkId=78955) has been defined to enable tracing across these boundaries. The schema enables the addition of custom, schema-compliant elements. You can use the Service Trace Viewer Tool (SvcTraceViewer.exe)http://go.microsoft.com/fwlink/p/?LinkId=240129 to display the event data.

EventSchemaTraceListener is tuned for logging performance with implicit support for lock-free tracing.

The T:System.Diagnostics.EventSchemaTraceListener class converts tracing and debugging information into an XML-encoded text stream. The description of the XML output is shown in the tables later in this section.

You can enable or disable an T:System.Diagnostics.EventSchemaTraceListener object through the application configuration file, and then use the configured T:System.Diagnostics.EventSchemaTraceListener object in your application. Alternately, you can create an T:System.Diagnostics.EventSchemaTraceListener object in your code. We recommend that you enable trace listeners through the application configuration file. For information about the use of configuration files for tracing and debugging, see Trace and Debug Settings Schema.

To configure an T:System.Diagnostics.EventSchemaTraceListener object, modify the configuration file that corresponds to the name of your application. In this file, you can add, remove, or set the properties for a listener. The configuration file should be formatted as follows:

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

The T:System.Diagnostics.EventSchemaTraceListener class inherits the P:System.Diagnostics.TraceListener.Filter property from the base class T:System.Diagnostics.TraceListener. The P:System.Diagnostics.TraceListener.Filter property allows for an additional level of trace output filtering at the listener. If a filter is present, the Trace methods of the trace listener call the M:System.Diagnostics.TraceFilter.ShouldTrace(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32,System.String,System.Object[],System.Object,System.Object[]) method of the filter to determine whether to emit the trace.

If an attempt is made to write to a file that is being used or is unavailable, a GUID suffix is automatically added to the file name.

System_CAPS_noteNota

Listener methods are intended to be called by methods of the T:System.Diagnostics.Debug, T:System.Diagnostics.Trace, and T:System.Diagnostics.TraceSource classes. Do not call the listener methods directly from application code. The T:System.Diagnostics.EventSchemaTraceListener listener is primarily intended for use by the T:System.Diagnostics.TraceSource class.

The following table describes the elements and attributes of the XML output.

Element

Attributes

Output

Notes

CallStack

None

Depends on the presence of the F:System.Diagnostics.TraceOptions.Callstack flag in the P:System.Diagnostics.TraceListener.TraceOutputOptions property.

Special characters such as > or < are replaced with escape sequences. See the escaped character translation table in the next table.

Computer

None

Always present.

This element represents the value of the P:System.Environment.MachineName property.

Correlation

ActivityID

Always present.

If ActivityID is not specified, the default is an empty GUID.

RelatedActivityID

Depends on the presence of the relatedActivityId parameter in the Trace method call.

The RelatedActivityID attribute corresponds to the relatedActivityId parameter of the M:System.Diagnostics.EventSchemaTraceListener.TraceTransfer(System.Diagnostics.TraceEventCache,System.String,System.Int32,System.String,System.Guid) method.

Data

None

Always present.

This element represents parameter input (data). One element is provided for each data object. In the case of event logs, the Data element contains escaped XML data. In the case of data logs, the Data element contains unescaped data. The data log output uses the ToString method of the passed-in data objects.

Event

None

Always present.

This element contains a trace event.

EventData

None

Present for event logs.

This element represents parameter input (message, args). It contains Data elements with escaped XML data that is created by calling the Overload:System.Diagnostics.EventSchemaTraceListener.TraceEvent method.

EventID

None

Always present.

This element represents parameter input (id).

Execution

ProcessID

Depends on the presence of the F:System.Diagnostics.TraceOptions.ProcessId flag in the P:System.Diagnostics.TraceListener.TraceOutputOptions property.

The ProcessID attribute is specified in the T:System.Diagnostics.TraceEventCache. On the Microsoft Windows 98 and Windows Millenium Edition operating systems, if ProcessID is larger than 2,147,483,647, it is a positive representation of a negative number and should be converted to obtain the correct process identifier.

ThreadID

Present when ProcessID is present.

The ThreadID attribute is specified in the T:System.Diagnostics.TraceEventCache.

Level

None

Always present.

This element represents parameter input (the numeric value of eventType). Parameter values that are larger than 255 are output as a level 8, which represents F:System.Diagnostics.TraceEventType.Information. Trace event types F:System.Diagnostics.TraceEventType.Critical, F:System.Diagnostics.TraceEventType.Error, F:System.Diagnostics.TraceEventType.Warning, F:System.Diagnostics.TraceEventType.Information, and F:System.Diagnostics.TraceEventType.Verbose are output as levels 1, 2, 4, 8, and 10, respectively.

LogicalOperationStack

None

Depends on the presence of the F:System.Diagnostics.TraceOptions.LogicalOperationStack flag in the P:System.Diagnostics.TraceListener.TraceOutputOptions property.

Only one logical operation can exist. Therefore, the values are written as LogicalOperation nodes under the LogicalOperationStack element.

OpCode

None

Present when Level is greater than 255.

This element represents Trace event types that have numeric values greater than 255. F:System.Diagnostics.TraceEventType.Start, F:System.Diagnostics.TraceEventType.Stop, F:System.Diagnostics.TraceEventType.Suspend, F:System.Diagnostics.TraceEventType.Resume, or F:System.Diagnostics.TraceEventType.Transfer are output as levels 1, 2, 4, 8, and 10, respectively.

Provider

GUID

Always present.

Always empty.

RenderingInfo

Culture

Always present.

This attribute represents a resource string for the event type. It is always "en-EN\".

System

Name

Always present.

TimeCreated

SystemTime

Depends on the presence of the F:System.Diagnostics.TraceOptions.DateTime flag in the P:System.Diagnostics.TraceListener.TraceOutputOptions property.

The time is the value of the P:System.Diagnostics.TraceEventCache.DateTime property. This property is expressed as Coordinated Universal Time

TimeStamp

None

Depends on the presence of the F:System.Diagnostics.TraceOptions.Timestamp flag in the P:System.Diagnostics.TraceListener.TraceOutputOptions property.

This element is specified in the T:System.Diagnostics.TraceEventCache.

UserData

None

Present for data logs.

This element contains Data elements with unescaped, user-provided data from a Overload:System.Diagnostics.EventSchemaTraceListener.TraceData method.

The following table shows the characters that are escaped in the XML output. Escaping occurs in all the elements and attributes except for the UserData element, which contains user-provided, unescaped data. The UserData element is a result of calls to the Overload:System.Diagnostics.EventSchemaTraceListener.TraceData method.

Escaped character

Value

&

&amp;

<

&lt;

>

&gt;

"

&quot;

\

&apos;

0xD

&#xD;

0xA

&#xA;

The following code example demonstrates how to use the T:System.Diagnostics.EventSchemaTraceListener class.

No hay ningún ejemplo de código disponible o este idioma no es compatible.

.NET Framework
Disponible desde 3.5

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: