ConsoleTraceListener 클래스

정의

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

public class ConsoleTraceListener : System.Diagnostics.TextWriterTraceListener

type ConsoleTraceListener = class
    inherit TextWriterTraceListener

Public Class ConsoleTraceListener
Inherits TextWriterTraceListener

상속

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

ConsoleTraceListener

예제

다음 코드 예제에서는 두 개의 공용 메서드를 사용 하 여 클래스로 구성 된 콘솔 애플리케이션을 구현 합니다.

메서드는 Main 명령줄 인수를 검사하고 추적 출력을 표준 오류 스트림 또는 표준 출력 스트림으로 전달해야 하는지 여부를 결정합니다. Main는 지정된 Console 출력 스트림에 대한 개체를 ConsoleTraceListener 만들고 초기화하고 이 개체를 추적 수신기 컬렉션에 추가합니다. 그런 다음 실행 중인 환경 및 추적 수신기 구성에 대한 세부 정보를 추적 출력에 기록하는 메서드를 호출 WriteEnvironmentInfoToTrace 합니다.

예제 애플리케이션을 실행 환경 및 추적 구성 세부 정보를 통해 지정 된 콘솔 출력 스트림에 기록 됩니다는 ConsoleTraceListener 개체입니다.

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

설명

클래스를 ConsoleTraceListener 사용하여 추적 및 디버깅 메시지를 콘솔에 씁니다. 개체를 ConsoleTraceListener 초기화하여 스트림 또는 Console.Error 스트림에 Console.Out 추적 메시지를 쓸 수 있습니다.

추적 및 디버깅 출력을 사용하도록 설정 ConsoleTraceListener 하면 메시지가 지정된 System.Console 스트림에 기록됩니다. 이는 또는 Console.WriteLine 메서드를 사용하여 메시지를 쓰는 방식과 Console.Write 유사합니다. 콘솔 애플리케이션에서는 합니다 System.Console 출력 및 오류 스트림을 기존 콘솔 창에 메시지를 작성 하거나 쓸 스트림을 리디렉션할 수 있습니다는 System.IO.TextWriter 인스턴스.

ConsoleTraceListener, TraceSource또는 Debug 을 통해 Trace작성된 메시지를 콘솔에 쓰려는 경우 적절한 Listeners 컬렉션에 개체를 추가합니다. 또한 또는 Trace.WriteLine 메서드를 사용하여 Trace.Write 콘솔에 직접 메시지를 쓸 수 있습니다.

대부분의 컴파일러에서는 조건부 컴파일 플래그를 통해 추적 및 디버그 출력을 사용하도록 설정합니다. 추적 또는 디버깅을 사용하도록 설정하지 않으면 및 System.Diagnostics.Trace 클래스를 통해 System.Diagnostics.Debug 작성된 메시지는 효과적으로 무시됩니다. 추적 및 디버그 출력을 사용하도록 설정하는 구문은 컴파일러에 따라 다릅니다. C# 또는 Visual Basic 이외의 컴파일러를 사용하는 경우 컴파일러에 대한 설명서를 참조하세요.

• C#에서 디버깅을 사용하도록 설정하려면 코드를 컴파일할 때 /d:DEBUG플래그를 컴파일러 명령줄에 추가하거나 파일 맨 위에 #define DEBUG 를 추가할 수 있습니다. Visual Basic에서 컴파일러 명령줄에 /d:DEBUG=True 플래그를 추가합니다.

• C#에서 추적을 사용하도록 설정하려면 코드를 컴파일할 때 컴파일러 명령줄에 /d:TRACE 플래그를 추가하거나 파일 맨 위에 #define TRACE 를 추가합니다. Visual Basic에서 컴파일러 명령줄에 /d:TRACE=True 플래그를 추가합니다.

코드의 컬렉션에 ConsoleTraceListener 개체를 Listeners 추가할 수 있습니다. 또는 .NET Framework 앱의 ConsoleTraceListener 경우 애플리케이션 구성 파일을 통해 컬렉션에 Listeners 개체를 추가할 수 있습니다. 코드에 개체를 ConsoleTraceListener 추가하여 특정 코드 섹션 또는 실행 경로에 대한 메시지를 작성합니다. 추가 된 ConsoleTraceListener 개체 모든 추적 및 디버그를 보내기 위해 애플리케이션 구성 파일에서 메시지를 콘솔 애플리케이션을 실행 하는 동안.

특정 코드 섹션에 대한 추적 및 디버그 메시지를 콘솔에 쓰려면 개체를 ConsoleTraceListener 초기화하고 컬렉션에 Listeners 추가합니다. 또는 Debug 클래스를 사용하여 메시지가 포함된 코드 섹션을 Trace 계측합니다. 코드 섹션의 끝에서 컬렉션에서 Listeners 개체를 ConsoleTraceListener 제거하고 에서 메서드를 CloseConsoleTraceListener호출합니다.

.NET Framework 앱의 경우 애플리케이션이 실행되는 동안 모든 추적 및 디버그 메시지를 콘솔로 보내려면 애플리케이션 구성 파일에 개체를 추가 ConsoleTraceListener 합니다. 다음 예제에서는 라는 개체를 ConsoleTraceListener 컬렉션에 추가합니다Listeners.configConsoleListener

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

애플리케이션 구성 파일에 추적 수신기를 추가하는 방법에 대한 자세한 내용은 수신기를 참조 <하세요>.

생성자

속성

메서드

적용 대상

추가 정보

• TraceListener
• TextWriterTraceListener
• Debug
• Trace
• Console