Trace 클래스

Trace 클래스의 속성 및 메서드를 사용하여 릴리스 빌드를 계측합니다. 이렇게 하면 실제 설정에서 실행되는 응용 프로그램의 상태를 모니터링할 수 있습니다. 추적 기능을 이용하여 실행 중인 시스템에 영향을 주지 않고 문제를 확인하여 해결할 수 있습니다.

참고
C#에서 추적을 활성화하려면 코드를 컴파일할 때 /d:TRACE 플래그를 컴파일러 명령줄에 추가하거나, #define TRACE를 파일 맨 위에 추가합니다. Visual Basic을 사용하는 경우 컴파일러 명령줄에 /d:TRACE=True 플래그를 추가합니다. C++에서 동일한 기능을 제공하려면 이 클래스의 메서드에 대한 호출을 #ifdef TRACE... #endif 블록으로 묶어야 합니다. 이 구문은 컴파일러 관련 구문입니다. 조건부 컴파일 특성은 Trace 클래스의 메서드에 배치되기 때문에 위에서 지정한 컴파일러 이외의 컴파일러를 사용하는 경우 해당 컴파일러의 설명서를 참조하여 조건부 컴파일을 활성화해야 합니다.

Visual Studio 2005 프로젝트에서 Trace는 기본적으로 활성화됩니다. 따라서 릴리스 및 디버그 빌드에서 Trace 메서드에 대한 코드가 생성되므로 프로그램을 다시 컴파일하지 않아도 생성된 코드를 추적하여 관련 문제를 확인할 수 있습니다. 반대로 릴리스 빌드에서는 기본적으로 Debug가 비활성화되기 때문에 Debug 메서드에 대한 실행 코드가 생성되지 않습니다. Trace를 비활성화하려면 Visual Studio 2005 설명서를 참조하십시오.

이 클래스는 Assert 대화 상자를 표시하는 메서드와 항상 Fail인 어설션을 내보내는 메서드를 제공합니다. 또한 이 클래스는 Write , WriteLine , WriteIf 및 WriteLineIf와 같은 변형된 Write 메서드를 제공합니다.

BooleanSwitch 및 TraceSwitch 클래스는 추적 출력을 동적으로 제어하는 방법을 제공합니다. 응용 프로그램을 다시 컴파일하지 않고도 이들 스위치 값을 수정할 수 있습니다. 구성 파일을 사용하여 스위치를 설정하는 방법에 대한 자세한 내용은 Switch 클래스 및 방법: 추적 스위치 구성 항목을 참조하십시오.

Listeners 컬렉션에서 TraceListener 인스턴스를 추가하거나 제거하여 추적 출력 대상을 사용자 지정할 수 있습니다. 기본적으로 DefaultTraceListener 클래스를 사용하여 추적 출력을 내보냅니다.

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

Trace의 AutoFlush 및 IndentSize를 설정하려면 응용 프로그램 이름과 일치하는 구성 파일을 편집합니다. 구성 파일의 형식은 다음 예제와 같아야 합니다.

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

Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows CE 플랫폼 참고: .NET Compact Framework에서는 구성 파일을 사용하는 추적 기능을 지원하지 않습니다.

다음 예제에서는 Trace를 사용하여 프로그램 실행의 시작과 끝을 보여 줍니다. 또한 이 예제에서는 Indent 및 Unindent를 사용하여 추적 출력을 구분합니다.

static int Main(string[] args)
{
   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();
   return 0;
}

• SecurityPermission  비관리 코드를 사용하여 작업하는 데 필요한 권한입니다. 요청 값 Demand; 연관된 열거형: SecurityPermissionFlag.UnmanagedCode.

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

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

.NET Framework

.NET Compact Framework