XmlWriterTraceListener Classe

Définition

public ref class XmlWriterTraceListener : System::Diagnostics::TextWriterTraceListener

public class XmlWriterTraceListener : System.Diagnostics.TextWriterTraceListener

type XmlWriterTraceListener = class
    inherit TextWriterTraceListener

Public Class XmlWriterTraceListener
Inherits TextWriterTraceListener

Héritage

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

XmlWriterTraceListener

Exemples

L’exemple de code suivant montre l’utilisation de la classe pour écrire à la XmlWriterTraceListener fois des données en échappement et non dans des journaux de fichiers.

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

Imports System.IO
Imports System.Xml
Imports System.Xml.XPath
Imports System.Diagnostics



Class testClass
    
    Shared Sub Main() 
        File.Delete("NotEscaped.xml")
        Dim ts As New TraceSource("TestSource")
        ts.Listeners.Add(New XmlWriterTraceListener("NotEscaped.xml"))
        ts.Switch.Level = SourceLevels.All
        Dim testString As String = "<Test><InnerElement Val=""1"" /><InnerElement Val=""Data""/><AnotherElement>11</AnotherElement></Test>"
        Dim myXml As New XmlTextReader(New StringReader(testString))
        Dim xDoc As New XPathDocument(myXml)
        Dim myNav As XPathNavigator = xDoc.CreateNavigator()
        ts.TraceData(TraceEventType.Error, 38, myNav)

        ts.Flush()
        ts.Close()
        
        File.Delete("Escaped.xml")
        Dim ts2 As 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()
    
    End Sub
End Class

Remarques

La XmlWriterTraceListener classe convertit les informations de suivi et de débogage en un flux de texte encodé en XML. La description de la sortie XML est indiquée dans les tableaux qui suivent. Vous pouvez utiliser l’outil Visionneuse de trace de service (SvcTraceViewer.exe) pour afficher la sortie XML.

Vous pouvez créer un XmlWriterTraceListener dans votre code. Pour les applications .NET Framework, vous pouvez également activer ou désactiver un via le fichier de configuration de XmlWriterTraceListener l’application, puis utiliser le configuré XmlWriterTraceListener dans votre application. Pour configurer un XmlWriterTraceListener, modifiez le fichier de configuration qui correspond au nom de votre application. Dans ce fichier, vous pouvez ajouter ou supprimer un écouteur, définir les propriétés d’un écouteur ou supprimer des écouteurs. Le fichier de configuration doit être mis en forme comme dans l’exemple suivant.

<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 classe hérite de la Filter propriété de la classe TraceListenerde base . La Filter propriété autorise un niveau supplémentaire de filtrage de sortie de trace au niveau de l’écouteur. S’il existe un filtre présent, les Trace méthodes de l’écouteur de trace appellent la ShouldTrace méthode du filtre pour déterminer s’il faut émettre la trace.

Le tableau suivant décrit les éléments et les attributs de la sortie XML.

Le tableau suivant montre les caractères qui sont placés dans une séquence d’échappement dans la sortie XML. L’échappement se produit dans tous les éléments et attributs à l’exception de l’élément, qui n’est pas placé dans une DataItem séquence d’échappement si l’objet passé au data paramètre de la TraceData méthode est un XPathNavigator objet . Si un XPathNavigator est utilisé pour l’objet de données, la MoveToRoot méthode est appelée et l’intégralité du nœud racine est tracée en tant que données sans séquence d’échappement.

Constructeurs

Propriétés

Méthodes

S’applique à