ConsoleTraceListener Klasse

Definition

public ref class ConsoleTraceListener : System::Diagnostics::TextWriterTraceListener

public class ConsoleTraceListener : System.Diagnostics.TextWriterTraceListener

type ConsoleTraceListener = class
    inherit TextWriterTraceListener

Public Class ConsoleTraceListener
Inherits TextWriterTraceListener

Vererbung

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

ConsoleTraceListener

Beispiele

Im folgenden Codebeispiel wird eine Konsolenanwendung implementiert, die aus einer Klasse mit zwei öffentlichen Methoden besteht.

Die Main -Methode untersucht die Befehlszeilenargumente und bestimmt, ob die Ablaufverfolgungsausgabe an den Standardfehlerdatenstrom oder den Standardausgabedatenstrom weitergeleitet werden soll. Main erstellt und initialisiert ein ConsoleTraceListener -Objekt für den angegebenen Console Ausgabedatenstrom und fügt dieses Objekt der Ablaufverfolgungslistenerauflistung hinzu. Anschließend wird die WriteEnvironmentInfoToTrace -Methode aufgerufen, die Details zur ausgeführten Umgebung und zur Konfiguration des Ablaufverfolgungslisteners in die Ablaufverfolgungsausgabe schreibt.

Wenn die Beispielanwendung ausgeführt wird, werden die Umgebungs- und Ablaufverfolgungskonfigurationsdetails über das -Objekt in den ConsoleTraceListener angegebenen Konsolenausgabestream geschrieben.

// Define the TRACE directive, which enables trace output to the
// Trace.Listeners collection. Typically, this directive is defined
// as a compilation argument.
#define TRACE
using System;
using System.Diagnostics;

public class ConsoleTraceSample
{

    // Define a simple method to write details about the current executing
    // environment to the trace listener collection.
    public static void WriteEnvironmentInfoToTrace()
    {

        string methodName = "WriteEnvironmentInfoToTrace";

        Trace.Indent();
        Trace.WriteLine(DateTime.Now.ToString() + " - Start of " + methodName);
        Trace.Indent();

        // Write details on the executing environment to the trace output.
        Trace.WriteLine("Operating system: " + System.Environment.OSVersion.ToString());
        Trace.WriteLine("Computer name: " + System.Environment.MachineName);
        Trace.WriteLine("User name: " + System.Environment.UserName);
        Trace.WriteLine("CLR runtime version: " + System.Environment.Version.ToString());
        Trace.WriteLine("Command line: " + System.Environment.CommandLine);

        // Enumerate the trace listener collection and
        // display details about each configured trace listener.
        Trace.WriteLine("Number of configured trace listeners = " + Trace.Listeners.Count.ToString());

        foreach (TraceListener tl in Trace.Listeners)
        {
            Trace.WriteLine("Trace listener name = " + tl.Name);
            Trace.WriteLine("               type = " + tl.GetType().ToString());
        }

        Trace.Unindent();
        Trace.WriteLine(DateTime.Now.ToString() + " - End of " + methodName);
        Trace.Unindent();
    }

    // Define the main entry point of this class.
    // The main method adds a console trace listener to the collection
    // of configured trace listeners, then writes details on the current
    // executing environment.
    public static void Main(string[] CmdArgs)
    {

        // Write a trace message to all configured trace listeners.
        Trace.WriteLine(DateTime.Now.ToString()+" - Start of Main");

        // Define a trace listener to direct trace output from this method
        // to the console.
        ConsoleTraceListener consoleTracer;

        // Check the command line arguments to determine which
        // console stream should be used for trace output.
        if ((CmdArgs.Length>0)&&(CmdArgs[0].ToString().ToLower().Equals("/stderr")))
            // Initialize the console trace listener to write
            // trace output to the standard error stream.
        {
            consoleTracer = new ConsoleTraceListener(true);
        }
        else
        {
            // Initialize the console trace listener to write
            // trace output to the standard output stream.
            consoleTracer = new ConsoleTraceListener();
        }
        // Set the name of the trace listener, which helps identify this
        // particular instance within the trace listener collection.
        consoleTracer.Name = "mainConsoleTracer";

        // Write the initial trace message to the console trace listener.
        consoleTracer.WriteLine(DateTime.Now.ToString()+" ["+consoleTracer.Name+"] - Starting output to trace listener.");

        // Add the new console trace listener to
        // the collection of trace listeners.
        Trace.Listeners.Add(consoleTracer);

        // Call a local method, which writes information about the current
        // execution environment to the configured trace listeners.
        WriteEnvironmentInfoToTrace();

        // Write the final trace message to the console trace listener.
        consoleTracer.WriteLine(DateTime.Now.ToString()+" ["+consoleTracer.Name+"] - Ending output to trace listener.");

        // Flush any pending trace messages, remove the
        // console trace listener from the collection,
        // and close the console trace listener.
        Trace.Flush();
        Trace.Listeners.Remove(consoleTracer);
        consoleTracer.Close();

        // Write a final trace message to all trace listeners.
        Trace.WriteLine(DateTime.Now.ToString()+" - End of Main");

        // Close all other configured trace listeners.
        Trace.Close();
    }
}

' Define the TRACE constant, which enables trace output to the 
' Trace.Listeners collection. Typically, this constant is defined
' as a compilation argument.
#Const TRACE = True

Imports System.Diagnostics

Public Class ConsoleTraceSample

    ' Define a simple method to write details about the current executing 
    ' environment to the trace listener collection.
    Public Shared Sub WriteEnvironmentInfoToTrace()

        Dim methodName As String = "WriteEnvironmentInfoToTrace"

        Trace.Indent()
        Trace.WriteLine(DateTime.Now.ToString() & " - Start of " & methodName)
        Trace.Indent()

        ' Write details on the executing environment to the trace output.
        Trace.WriteLine("Operating system: " & _
            System.Environment.OSVersion.ToString())
        Trace.WriteLine("Computer name: " & System.Environment.MachineName)
        Trace.WriteLine("User name: " & System.Environment.UserName)
        Trace.WriteLine("CLR version: " & System.Environment.Version.ToString)
        Trace.WriteLine("Command line: " & System.Environment.CommandLine)

        ' Enumerate the trace listener collection and 
        ' display details about each configured trace listener.
        Trace.WriteLine("Number of configured trace listeners = " & _
            Trace.Listeners.Count.ToString())

        Dim tl As TraceListener
        For Each tl In Trace.Listeners
            Trace.WriteLine("Trace listener name = " & tl.Name)
            Trace.WriteLine("               type = " & tl.GetType().ToString())
        Next tl

        Trace.Unindent()
        Trace.WriteLine(DateTime.Now.ToString() & " - End of " & methodName)
        Trace.Unindent()

    End Sub

    ' Define the main entry point of this class.
    ' The main method adds a console trace listener to the collection
    ' of configured trace listeners, then writes details on the current
    ' executing environment.
    Public Shared Sub Main(ByVal CmdArgs() As String)

        ' Write a trace message to all configured trace listeners.
        Trace.WriteLine(DateTime.Now.ToString() & " - Start of Main")

        ' Define a trace listener to direct trace output from this method
        ' to the console.
        Dim consoleTracer As ConsoleTraceListener

        ' Check the command line arguments to determine which
        ' console stream should be used for trace output.
        If (CmdArgs.Length > 0) AndAlso _
           (CmdArgs(0).ToLower.Equals("/stderr")) Then
            ' Initialize the console trace listener to write
            ' trace output to the standard error stream.
            consoleTracer = New ConsoleTraceListener(True)
        Else
            ' Initialize the console trace listener to write
            ' trace output to the standard output stream.
            consoleTracer = New ConsoleTraceListener
        End If
        ' Set the name of the trace listener, which helps identify this 
        ' particular instance within the trace listener collection.
        consoleTracer.Name = "mainConsoleTracer"

        ' Write the initial trace message to the console trace listener.
        consoleTracer.WriteLine(DateTime.Now.ToString() & " [" & _
             consoleTracer.Name & "] - Starting output to trace listener.")

        ' Add the new console trace listener to 
        ' the collection of trace listeners.
        Trace.Listeners.Add(consoleTracer)

        ' Call a local method, which writes information about the current 
        ' execution environment to the configured trace listeners.
        WriteEnvironmentInfoToTrace()

        ' Write the final trace message to the console trace listener.
        consoleTracer.WriteLine(DateTime.Now.ToString() & " [" & _
            consoleTracer.Name & "] - Ending output to trace listener.")

        ' Flush any pending trace messages, remove the 
        ' console trace listener from the collection,
        ' and close the console trace listener.
        Trace.Flush()
        Trace.Listeners.Remove(consoleTracer)
        consoleTracer.Close()

        ' Write a final trace message to all trace listeners.
        Trace.WriteLine(DateTime.Now.ToString() + " - End of Main")

        ' Close all other configured trace listeners.
        Trace.Close()

    End Sub

End Class

Hinweise

Verwenden Sie die ConsoleTraceListener -Klasse, um Ablaufverfolgungs- und Debugnachrichten in die Konsole zu schreiben. Sie können ein ConsoleTraceListener -Objekt initialisieren, um Ablaufverfolgungsmeldungen in den Console.Out Stream oder in den Console.Error Stream zu schreiben.

Wenn die Ausgabe der Ablaufverfolgung und des Debuggens aktiviert ist, werden die ConsoleTraceListener Nachrichten in den angegebenen System.Console Stream geschrieben, was der Art und Weise ähnelt, wie Nachrichten mit den Console.Write Methoden oder Console.WriteLine geschrieben werden. In einer Konsolenanwendung schreiben die System.Console Ausgabe- und Fehlerstreams Nachrichten an das vorhandene Konsolenfenster, oder Sie können die Streams zum Schreiben an eine System.IO.TextWriter instance umleiten.

Fügen Sie der entsprechenden Auflistung ein ConsoleTraceListener -Objekt hinzu, wenn Nachrichten, die über Trace, TraceSourceoder Debug geschrieben werden, in die Konsole geschrieben werden sollen.Listeners Darüber hinaus können Sie Nachrichten direkt in die Konsole schreiben, indem Sie die Trace.Write Methoden oder Trace.WriteLine verwenden.

Die meisten Compiler aktivieren die Ablaufverfolgungs- und Debugausgabe über Flags für die bedingte Kompilierung. Wenn Sie die Ablaufverfolgung oder das Debuggen nicht aktivieren, werden die über die System.Diagnostics.Debug Klassen und System.Diagnostics.Trace geschriebenen Nachrichten effektiv ignoriert. Die Syntax zum Aktivieren der Ablaufverfolgungs- und Debugausgabe 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 Flag /d:DEBUGder Compilerbefehlszeile hinzu, wenn Sie Ihren Code kompilieren, oder Sie können #define DEBUG am Anfang der Datei hinzufügen. Fügen Sie in Visual Basic der Compilerbefehlszeile das Flag /d:DEBUG=True hinzu.

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

Sie können der Listeners Auflistung in Ihrem Code ein ConsoleTraceListener -Objekt hinzufügen. Alternativ können Sie für .NET Framework-Apps der Auflistung über die Listeners Anwendungskonfigurationsdatei ein ConsoleTraceListener -Objekt hinzufügen. Fügen Sie das ConsoleTraceListener -Objekt in Ihrem Code hinzu, um Nachrichten für einen bestimmten Codeabschnitt oder Ausführungspfad zu schreiben. Fügen Sie das ConsoleTraceListener -Objekt in Ihrer Anwendungskonfigurationsdatei hinzu, um alle Ablaufverfolgungs- und Debugmeldungen an die Konsole weiterzuleiten, während die Anwendung ausgeführt wird.

Um Ablaufverfolgungs- und Debugnachrichten für einen bestimmten Codeabschnitt in die Konsole zu schreiben, initialisieren Sie ein ConsoleTraceListener -Objekt, und fügen Sie es der Listeners Auflistung hinzu. Instrumentieren Sie den Codeabschnitt, der Nachrichten enthält, mithilfe der -Klasse oder Debug der Trace -Klasse. Entfernen Sie am Ende des Codeabschnitts das ConsoleTraceListener -Objekt aus der Listeners Auflistung, und rufen Sie die Close -Methode für auf ConsoleTraceListener.

Fügen Sie für .NET Framework-Apps der Anwendungskonfigurationsdatei ein ConsoleTraceListener -Objekt hinzu, um alle Ablaufverfolgungs- und Debugnachrichten an die Konsole weiterzuleiten, während die Anwendung ausgeführt wird. Im folgenden Beispiel wird der Auflistung ein ConsoleTraceListener -Objekt mit dem Listeners Namen configConsoleListener hinzugefügt.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="configConsoleListener" type="System.Diagnostics.ConsoleTraceListener" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
 </configuration>  

Ausführliche Informationen zum Hinzufügen von Ablaufverfolgungslistenern in der Anwendungskonfigurationsdatei finden Sie unter <Listener>.

Konstruktoren

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• TraceListener
• TextWriterTraceListener
• Debug
• Trace
• Console