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 XmlWriterTraceListener

 

Publicado: octubre de 2016

Dirige seguimiento o de salida de depuración como datos codificados en XML para un TextWriter o un Stream, como un FileStream.

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

System.Object
  System.MarshalByRefObject
    System.Diagnostics.TraceListener
      System.Diagnostics.TextWriterTraceListener
        System.Diagnostics.XmlWriterTraceListener

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

NombreDescripción
System_CAPS_pubmethodXmlWriterTraceListener(Stream)

Inicializa una nueva instancia de la XmlWriterTraceListener clase, utilizando la secuencia especificada como destinatario de los resultados del seguimiento y la depuración.

System_CAPS_pubmethodXmlWriterTraceListener(Stream, String)

Inicializa una nueva instancia de la XmlWriterTraceListener clase con el nombre especificado, utilizando la secuencia especificada como destinatario de la depuración y resultados de seguimiento.

System_CAPS_pubmethodXmlWriterTraceListener(String)

Inicializa una nueva instancia de la XmlWriterTraceListener clase, mediante el archivo especificado como destinatario de los resultados del seguimiento y la depuración.

System_CAPS_pubmethodXmlWriterTraceListener(String, String)

Inicializa una nueva instancia de la XmlWriterTraceListener clase con el nombre especificado, utilizando el archivo especificado como destinatario de la depuración y resultados de seguimiento.

System_CAPS_pubmethodXmlWriterTraceListener(TextWriter)

Inicializa una nueva instancia de la XmlWriterTraceListener clase utilizando el escritor especificado como destinatario de la depuración y resultados de seguimiento.

System_CAPS_pubmethodXmlWriterTraceListener(TextWriter, String)

Inicializa una nueva instancia de la XmlWriterTraceListener clase con el nombre especificado, utilizando el escritor especificado como destinatario de la depuración y resultados de seguimiento.

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

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

System_CAPS_pubpropertyWriter

Obtiene o establece el escritor de texto que recibe el seguimiento o la depuración de salida.(Heredado de TextWriterTraceListener).

NombreDescripción
System_CAPS_pubmethodClose()

Cierra el Writer para este agente de escucha para que ya no recibe seguimiento o de depuración de salida.(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 seguimiento incluye un mensaje de error y un mensaje de error detallado en el archivo o secuencia.(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()

Vacía el búfer de salida para el Writer.(Heredado de TextWriterTraceListener).

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_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 objeto de datos e información de evento en el archivo o la secuencia.(Invalida TraceListener.TraceData(TraceEventCache, String, TraceEventType, Int32, Object)).

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

Escribe la información de seguimiento, objetos de datos y la información de evento en el archivo o la secuencia.(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 información de seguimiento, un mensaje e información de evento en el archivo o la secuencia.(Invalida TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)).

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

Escribe la información de seguimiento, un mensaje con formato e información de evento en el archivo o la secuencia.(Invalida TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])).

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

Escribe información de seguimiento incluida la identidad de una información de actividad, un mensaje y eventos relacionado en el archivo o secuencia.(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 textual sin información de contexto adicional en el archivo o la secuencia.(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 textual sin información de contexto adicional seguida del terminador de línea actual en la secuencia o archivo.(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).

System_CAPS_noteNota

Debe tener permiso no administrado código para crear una instancia de la XmlWriterTraceListener clase.

La XmlWriterTraceListener 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 siguientes. Puede usar el Service Trace Viewer Tool (SvcTraceViewer.exe) mostrar el código XML de salida.

Puede habilitar o deshabilitar un XmlWriterTraceListener a través del archivo de configuración de aplicación y a continuación, utilice el XmlWriterTraceListener en la aplicación. Como alternativa, puede crear un XmlWriterTraceListener en el código.

Para configurar un XmlWriterTraceListener, edite el archivo de configuración que corresponde al nombre de la aplicación. En este archivo, puede agregar o quitar un agente de escucha, establecer las propiedades de un agente de escucha o quitar agentes de escucha. El archivo de configuración se debe dar formato como en el ejemplo siguiente.

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="xmlListener" 
          type="System.Diagnostics.XmlWriterTraceListener" 
          initializeData="xmlOutput.xml" 
          traceOutputOptions="ProcessId, DateTime" />
        <remove name="Default" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

La XmlWriterTraceListener 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 hay 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.

System_CAPS_noteNota

Si intenta escribir en un archivo que está en uso o no está disponible, el nombre de archivo automáticamente viene precedido por un GUID.

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. Los métodos de agente de escucha no pretenden llamar directamente desde el código de la aplicación. La XmlWriterTraceListener agente de escucha está pensado principalmente para su uso por el TraceSource clase. El Write y WriteLine pueden llamar a métodos del Trace y Debug se proporcionan clases y los valores predeterminados para los elementos XML que Trace y Debug no se proporcionan valores para.

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 que sigue.

Computer

NONE

Siempre está presente.

Valor de propiedad MachineName.

Correlation

ActivityID

Siempre presente

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

RelatedActivityID

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

El relatedActivityId parámetro de la TraceTransfer (método).

DataItem

NONE

Depende de la data parámetro de la TraceData (método).

Este elemento puede contener una matriz de elementos o un elemento, por lo que los valores se escriben como un conjunto de DataItem nodos bajo el TraceData elemento.

Los datos de salida utiliza la ToString método de los objetos de datos en el pasado.

EventID

NONE

Siempre está presente.

Entrada de parámetro (id).

Execution

ProcessName

Siempre está presente.

Desde el TraceEventCache.

ProcessID

Siempre está presente.

Desde el TraceEventCache. En Windows 98 y Windows Me 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

Siempre está presente.

Desde el TraceEventCache.

Level

NONE

Siempre está presente.

Entrada de parámetro (el valor numérico de eventType). Los valores de parámetro mayores que 255 salen como 255.

LogicalOperationStack

NONE

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

Puede haber más de una operación lógica, por lo que los valores se escriben como LogicalOperation nodos bajo el LogicalOperationStack elemento.

Message

NONE

Depende de la presencia de un mensaje en la llamada al método de seguimiento.

Este elemento es un mensaje con formato si se proporcionan argumentos de formato.

Source

Name

Siempre está presente.

Parámetro de entrada.

SubType

Name

Siempre está presente.

Parámetro de entrada.

TimeCreated

SystemTime

Siempre está presente.

Si no está presente en el TraceEventCache, el valor predeterminado es la hora actual.

TimeStamp

NONE

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

Desde el TraceEventCache.

Type

NONE

Siempre está presente.

Siempre es el valor 3.

La siguiente tabla muestra los caracteres de escape en los resultados XML. Secuencias de escape se produce en todos los elementos y atributos con la excepción de la DataItem elemento, que no se puede salir si el objeto pasado a la data parámetro de la TraceData método es un XPathNavigator objeto. Si un XPathNavigator se utiliza para el objeto de datos, el MoveToRoot se llama al método y se realiza un seguimiento del todo el nodo raíz como datos sin escape.

Carácter de escape

Valor

&

&amp;

<

&lt;

>

&gt;

"

&quot;

\

&apos;

0xD

&#xD;

0xA

&#xA;

En el ejemplo de código siguiente se muestra el uso de la XmlWriterTraceListener clase para escribir datos de escape y sin escape en registros de archivos.

using System;
using System.IO;
using System.Xml;
using System.Xml.XPath;
using System.Diagnostics;

class testClass
{
    static void Main()
    {
        File.Delete("NotEscaped.xml");
        TraceSource ts = new TraceSource("TestSource");
        ts.Listeners.Add(new XmlWriterTraceListener("NotEscaped.xml"));
        ts.Switch.Level = SourceLevels.All;
        string testString = "<Test><InnerElement Val=\"1\" /><InnerElement Val=\"Data\"/><AnotherElement>11</AnotherElement></Test>";
        XmlTextReader myXml = new XmlTextReader(new StringReader(testString));
        XPathDocument xDoc = new XPathDocument(myXml);
        XPathNavigator myNav = xDoc.CreateNavigator();
        ts.TraceData(TraceEventType.Error, 38, myNav);

        ts.Flush();
        ts.Close();

        File.Delete("Escaped.xml");
        TraceSource ts2 = new TraceSource("TestSource2");
        ts2.Listeners.Add(new XmlWriterTraceListener("Escaped.xml"));
        ts2.Switch.Level = SourceLevels.All;
        ts2.TraceData(TraceEventType.Error, 38, testString);

        ts2.Flush();
        ts2.Close();
    }
}

SecurityPermission

for the ability to call unmanaged code. Associated enumeration: P:System.Security.Permissions.SecurityPermissionAttribute.UnmanagedCode.

.NET Framework
Disponible desde 2.0

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: