Trace 클래스

정의

public ref class Trace sealed

public sealed class Trace

type Trace = class

Public NotInheritable Class Trace

상속

Object

Trace

예제

다음 예제에서는 프로그램 실행의 시작과 끝을 나타내는 데 사용합니다 Trace . 또한 이 예제에서는 추적 출력을 Trace.Indent 구분하기 위해 및 Trace.Unindent 메서드를 사용합니다. 사용 Trace의 자세한 예제는 방법: 애플리케이션 코드에 추적 문 추가를 참조하세요.

// Specify /d:TRACE when compiling.

using System;
using System.Diagnostics;

class Test
{
    static void Main()
    {
       Trace.Listeners.Add(new TextWriterTraceListener(Console.Out));
       Trace.AutoFlush = true;
       Trace.Indent();
       Trace.WriteLine("Entering Main");
       Console.WriteLine("Hello World.");
       Trace.WriteLine("Exiting Main");
       Trace.Unindent();
    }
}

' Specify /d:TRACE=True when compiling.

Imports System.Diagnostics

Class Test
    
    Shared Sub Main()
    
        Trace.Listeners.Add(New TextWriterTraceListener(Console.Out))
        Trace.AutoFlush = True
        Trace.Indent()
        Trace.WriteLine("Entering Main")
        Console.WriteLine("Hello World.")
        Trace.WriteLine("Exiting Main")
        Trace.Unindent()
        
    End Sub

End Class

설명

클래스의 속성과 메서드를 Trace 사용하여 릴리스 빌드를 계측할 수 있습니다. 계측을 사용하면 실제 설정에서 실행되는 애플리케이션의 상태를 모니터링할 수 있습니다. 추적을 사용하면 실행 중인 시스템을 방해하지 않고 문제를 격리하고 해결할 수 있습니다.

이 클래스는 대화 상자를 표시 Assert 하고 항상 Fail수행할 어설션을 내보내는 메서드를 제공합니다. 이 클래스는 다음과 같은 변형으로 쓰기 메서드를 제공합니다.

• Write
• WriteLine
• WriteIf
• WriteLineIf

및 BooleanSwitch 클래스는 TraceSwitch 추적 출력을 동적으로 제어하는 수단을 제공합니다. .NET Framework 앱에서는 애플리케이션을 다시 컴파일하지 않고도 이러한 스위치의 값을 수정할 수 있습니다. 구성 파일을 사용하여 .NET Framework 앱에서 스위치를 설정하는 방법에 대한 자세한 내용은 Switch 클래스 및 방법: 추적 스위치 만들기, 초기화 및 구성 참조하세요.

컬렉션에 인스턴스를 추가 TraceListener 하거나 컬렉션에서 Listeners 인스턴스를 제거하여 추적 출력의 대상을 사용자 지정할 수 있습니다. 컬렉션은 Listeners 클래스와 Debug 클래스 모두에서 Trace 공유됩니다. 두 클래스에 추적 수신기를 추가하면 수신기가 둘 다에 추가됩니다. 기본적으로 추적 출력은 클래스를 사용하여 내보내집니다 DefaultTraceListener .

클래스는 Trace 각 쓰기 후의 수준과 수준 Indent 및 IndentSize설정 여부를 AutoFlush 가져오기 또는 설정하는 속성을 제공합니다.

.NET Framework 앱에서는 애플리케이션 이름에 해당하는 구성 파일을 편집하여 AutoFlush 및 IndentSizeTrace 설정할 수 있습니다. 구성 파일의 형식은 다음 예제와 같이 지정해야 합니다.

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="3" />
  </system.diagnostics>
</configuration>

특성은 ConditionalAttribute .의 Trace메서드에 적용됩니다. 조건부 컴파일 기호로 정의되지 않는 한 ConditionalAttribute 이러한 메서드에 대한 호출을 지원하는 TRACE 컴파일러가 무시됩니다. 컴파일러의 설명서를 참조하여 지원되는지 여부 ConditionalAttribute 와 조건부 컴파일 기호를 정의하는 구문을 확인합니다.

C#에서 조건부 컴파일 기호를 정의 TRACE 하려면 명령줄을 사용하여 코드를 컴파일할 때 컴파일러 명령줄에 옵션을 추가 /d:TRACE 하거나 파일 맨 위에 추가 #define TRACE 합니다. Visual Basic에서 컴파일러 명령줄에 옵션을 추가 /d:TRACE=True 하거나 파일에 추가 #Const TRACE=True 합니다.

ConditionalAttribute 는 C++ 컴파일러에서 지원되지 않습니다. 동등한 기능을 제공하려면 블록의 Trace#if defined(TRACE) ... #endif 메서드에 대한 호출을 묶고 컴파일러 명령줄에 옵션을 추가 /DTRACE 하거나 파일에 추가 #define TRACE 해야 합니다.

스레드 보안

이 형식은 스레드로부터 안전합니다.

추가 정보

• Debug
• Switch
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• EventLogTraceListener
• TraceListenerCollection
• ConditionalAttribute