TextWriterTraceListener Klasse

Definition

public ref class TextWriterTraceListener : System::Diagnostics::TraceListener

public class TextWriterTraceListener : System.Diagnostics.TraceListener

type TextWriterTraceListener = class
    inherit TraceListener

Public Class TextWriterTraceListener
Inherits TraceListener

Vererbung

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

Vererbung

Object

TraceListener

TextWriterTraceListener

Abgeleitet

System.Diagnostics.ConsoleTraceListener

System.Diagnostics.DelimitedListTraceListener

System.Diagnostics.EventSchemaTraceListener

System.Diagnostics.XmlWriterTraceListener

Beispiele

Im folgenden Beispiel wird eine instance der -Klasse implementiert, die TextWriterTraceListener einen aufgerufenen myOutputWriter verwendet, um in eine Datei mit dem Namen TestFile.txtzu StreamWriter schreiben. Zunächst wird im Beispiel eine Datei für die Ausgabe erstellt. Anschließend erstellt es den StreamWriter für den ersten Textschreiber, weist ihm die Ausgabedatei zu und fügt es dem Listenershinzu. Anschließend gibt der Code eine Textzeile in die Datei aus. Schließlich löscht das Beispiel den Ausgabepuffer.

Nachdem Sie dieses Beispiel ausgeführt haben, können Sie die TestFile.txt Datei öffnen, um die Ausgabe anzuzeigen.

void main()
{
   #if defined(TRACE)
   // Create a file for output named TestFile.txt.
   Stream^ myFile = File::Create( "TestFile.txt" );
   
   // Create a new text writer using the output stream and
   // add it to the trace listeners.
   TextWriterTraceListener^ myTextListener = 
      gcnew TextWriterTraceListener( myFile );
   Trace::Listeners->Add( myTextListener );
  
   // Write output to the file.
   Trace::Write( "Test output " );
  
   // Flush the output.
   Trace::Flush();
   Trace::Close();
   #endif
}

public class Sample
{

public static int Main(string[] args) {
    // Create a file for output named TestFile.txt.
    Stream myFile = File.Create("TestFile.txt");

    /* Create a new text writer using the output stream, and add it to
     * the trace listeners. */
    TextWriterTraceListener myTextListener = new
       TextWriterTraceListener(myFile);
    Trace.Listeners.Add(myTextListener);

    // Write output to the file.
    Trace.Write("Test output ");

    // Flush the output.
    Trace.Flush();

    return 0;
 }
}

Public Class Sample
    
    Public Shared Sub Main()
        ' Create a file for output named TestFile.txt.
        Dim myFile As Stream = File.Create("TestFile.txt")
        
        ' Create a new text writer using the output stream, and add it to
        ' the trace listeners. 
        Dim myTextListener As New TextWriterTraceListener(myFile)
        Trace.Listeners.Add(myTextListener)

        
        ' Write output to the file.
        Trace.Write("Test output ")
        
        ' Flush the output.
        Trace.Flush() 

        System.Environment.ExitCode = 0
    End Sub

End Class

Hinweise

Die TextWriterTraceListener -Klasse stellt die Writer -Eigenschaft bereit, um den Textschreiber abzurufen oder festzulegen, der die Ablaufverfolgungs- oder Debugausgabe empfängt.

Diese Klasse stellt auch Methoden für Close die Writer bereit, sodass sie keine Ablaufverfolgungs- oder Debugausgabe mehr empfängt, an Flush den Ausgabepuffer für den Writerund eine Write Nachricht an den Writer.

Sie müssen die Ablaufverfolgung oder das Debuggen aktivieren, um einen Ablaufverfolgungslistener verwenden zu können. Die folgende Syntax ist compilerspezifisch. Wenn Sie andere Compiler als C# oder Visual Basic verwenden, lesen Sie die Dokumentation für Ihren Compiler.

• Um das Debuggen in C# zu aktivieren, fügen Sie das /d:DEBUG Flag der Compiler-Befehlszeile hinzu, wenn Sie Ihren Code kompilieren, oder Sie können die Datei oben hinzufügen #define DEBUG . Fügen Sie in Visual Basic der Compiler-Befehlszeile das /d:DEBUG=True Flag hinzu.

• Um die Ablaufverfolgung in C# zu aktivieren, fügen Sie das /d:TRACE Flag der Compilerbefehlszeile hinzu, wenn Sie Ihren Code kompilieren, oder fügen Sie das Flag am Anfang der Datei hinzu #define TRACE . Fügen Sie in Visual Basic der Compiler-Befehlszeile das /d:TRACE=True Flag hinzu.

Um einen Ablaufverfolgungslistener in einer .NET Framework-App hinzuzufügen, bearbeiten Sie die Konfigurationsdatei, die dem Namen Ihrer Anwendung entspricht. In dieser Datei können Sie einen Listener hinzufügen, dessen Typ festlegen und seinen Parameter festlegen, einen Listener entfernen oder alle zuvor von der Anwendung festgelegten Listener löschen. Die Konfigurationsdatei sollte wie im folgenden Beispiel formatiert sein.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="myListener"   
          type="System.Diagnostics.TextWriterTraceListener"   
          initializeData="TextWriterOutput.log" />  
        <remove name="Default" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Konstruktoren

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• Stream
• TextWriter
• Debug
• Trace