XmlWriterTraceListener Klasse

Definition

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

public class XmlWriterTraceListener : System.Diagnostics.TextWriterTraceListener

type XmlWriterTraceListener = class
    inherit TextWriterTraceListener

Public Class XmlWriterTraceListener
Inherits TextWriterTraceListener

Vererbung

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

XmlWriterTraceListener

Beispiele

Im folgenden Codebeispiel wird die Verwendung der XmlWriterTraceListener -Klasse veranschaulicht, um sowohl mit Escapezeichen versehene als auch nicht mit Escape versehene Daten in Dateiprotokolle zu schreiben.

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

Hinweise

Die XmlWriterTraceListener -Klasse konvertiert Ablaufverfolgungs- und Debuginformationen in einen XML-codierten Textstream. Die Beschreibung der XML-Ausgabe wird in den folgenden Tabellen angezeigt. Sie können das Service Trace Viewer-Tool (SvcTraceViewer.exe) verwenden, um die XML-Ausgabe anzuzeigen.

Sie können einen XmlWriterTraceListener in Ihrem Code erstellen. Alternativ können Sie für .NET Framework-Apps eine über die Anwendungskonfigurationsdatei XmlWriterTraceListener aktivieren oder deaktivieren und dann die in Ihrer Anwendung konfigurierte XmlWriterTraceListener verwenden. Um eine XmlWriterTraceListenerzu konfigurieren, bearbeiten Sie die Konfigurationsdatei, die dem Namen Ihrer Anwendung entspricht. In dieser Datei können Sie einen Listener hinzufügen oder entfernen, die Eigenschaften für einen Listener festlegen oder Listener entfernen. Die Konfigurationsdatei sollte wie im folgenden Beispiel formatiert sein.

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

Die XmlWriterTraceListener -Klasse erbt die Filter -Eigenschaft von der Basisklasse TraceListener. Die Filter -Eigenschaft ermöglicht eine zusätzliche Ebene der Ablaufverfolgungsausgabefilterung am Listener. Wenn ein Filter vorhanden ist, rufen die Trace Methoden des Ablaufverfolgungslisteners die ShouldTrace Methode des Filters auf, um zu bestimmen, ob die Ablaufverfolgung ausgegeben werden soll.

In der folgenden Tabelle werden die Elemente und Attribute der XML-Ausgabe beschrieben.

Die folgende Tabelle zeigt die Zeichen, die in der XML-Ausgabe mit Escapezeichen versehen werden. Das Escapevorgang erfolgt in allen Elementen und Attributen mit Ausnahme des DataItem Elements, das nicht mit escaped versehen wird, wenn das an den Parameter der dataTraceData Methode übergebene Objekt ein XPathNavigator Objekt ist. Wenn ein XPathNavigator für das Datenobjekt verwendet wird, wird die MoveToRoot -Methode aufgerufen, und der gesamte Stammknoten wird als unescaped-Daten nachverfolgt.

Konstruktoren

Eigenschaften

Methoden

Gilt für: