Trace 클래스

정의

코드의 실행을 추적하는 데 도움이 되는 메서드와 속성 집합을 제공합니다.Provides a set of methods and properties that help you trace the execution of your code. 이 클래스는 상속될 수 없습니다.This class cannot be inherited.

public ref class Trace sealed
public sealed class Trace
type Trace = class
Public NotInheritable Class Trace
상속
Trace

예제

다음 예제에서는 Trace 시작과 프로그램 실행의 끝을 나타냅니다.The following example uses Trace to indicate the beginning and the end of a program's execution. 또한이 예제에서는 합니다 Trace.IndentTrace.Unindent 추적 출력을 구분 하는 방법입니다.The example also uses the Trace.Indent and Trace.Unindent methods to distinguish the tracing output. 보다 완전 한 예제 사용에 대 한 Trace를 참조 하세요 방법: 애플리케이션 코드에 Trace 문 추가합니다.For a more complete example of the use of Trace, see How to: Add Trace Statements to Application Code.

// Specify /DTRACE when compiling.

#using <System.dll>
using namespace System;
using namespace System::Diagnostics;

int main()
{
   #if defined(TRACE)
   Trace::Listeners->Add( gcnew TextWriterTraceListener( Console::Out ) );
   Trace::AutoFlush = true;
   Trace::Indent();
   Trace::WriteLine( "Entering Main" );
   #endif
   Console::WriteLine( "Hello World." );
   #if defined(TRACE)
   Trace::WriteLine( "Exiting Main" );
   Trace::Unindent();
   #endif
   return 0;
}
// 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 클래스 계측 릴리스를 빌드합니다.You can use the properties and methods in the Trace class to instrument release builds. 계측을 사용 하면 실제 설정에서 실행 중인 애플리케이션의 상태를 모니터링할 수 있습니다.Instrumentation allows you to monitor the health of your application running in real-life settings. 추적 기능을 이용 문제를 격리 하 고 실행 중인 시스템을 방해 하지 않고 수정 합니다.Tracing helps you isolate problems and fix them without disturbing a running system.

표시할 메서드를 제공 하는이 클래스는 Assert 대화 상자를 항상는 어설션을 내보내려고 Fail합니다.This class provides methods to display an Assert dialog box, and to emit an assertion that will always Fail. 이 클래스는 다음과 같은 형태로 write 메서드를 제공 합니다. Write, WriteLine, WriteIf, 및 WriteLineIf합니다.This class provides write methods in the following variations: Write, WriteLine, WriteIf, and WriteLineIf.

합니다 BooleanSwitchTraceSwitch 클래스는 추적 출력을 동적으로 제어 하는 수단을 제공 합니다.The BooleanSwitch and TraceSwitch classes provide means to dynamically control the tracing output. 애플리케이션을 다시 컴파일하지 않고도 이러한 스위치의 값을 수정할 수 있습니다.You can modify the values of these switches without recompiling your application. 구성 파일을 사용 하 여 스위치 Switch 를 설정 하는 방법에 대 한 자세한 내용은 클래스 및 방법: 추적 스위치 만들기, 초기화 및 구성 항목을 참조 하세요.For information on using the configuration file to set a switch, see the Switch class and the How to: Create, Initialize and Configure Trace Switches topic.

추적 출력의 대상을 추가 하 여 사용자 지정할 수 있습니다 TraceListener 인스턴스를 하거나 인스턴스를 제거 합니다 Listeners 컬렉션입니다.You can customize the tracing output's target by adding TraceListener instances to or removing instances from the Listeners collection. 합니다 Listeners 컬렉션 모두에 의해 공유 되는 DebugTrace 클래스; 둘 다에 수신기를 추가 하는 클래스를 추적 수신기를 추가 합니다.The Listeners collection is shared by both the Debug and the Trace classes; adding a trace listener to either class adds the listener to both. 사용 하 여 추적 출력을 내보냅니다 하는 기본적으로 DefaultTraceListener 클래스입니다.By default, trace output is emitted using the DefaultTraceListener class.

참고

추적 수신기를 추가 합니다 Listeners 컬렉션 추적 수신기에서 사용 하는 리소스를 사용할 수 없는 경우 추적 하는 동안 throw 된 예외가 발생할 수 있습니다.Adding a trace listener to the Listeners collection can cause an exception to be thrown while tracing, if a resource used by the trace listener is not available. 조건 및 throw 된 예외 추적 수신기에 따라 다르며이 항목의 열거할 수 없습니다.The conditions and the exception thrown depend on the trace listener and cannot be enumerated in this topic. 전화를 걸 수 유용할 수 있습니다는 Trace 의 메서드 try / catch 요소를 감지 하 여 추적 수신기에서 예외를 처리 합니다.It may be useful to place calls to the Trace methods in try/catch blocks to detect and handle any exceptions from trace listeners.

참고

부분적으로 신뢰할 수 있는 코드에 추적 수신기를 추가 하는 경우는 SecurityException 예외를 추적 수신기를 추가 하기 때문에 필요 UnmanagedCode 권한.If you add trace listeners to partially trusted code, you will get a SecurityException exception, because adding trace listeners requires UnmanagedCode permission. Visual Studio에서 샌드박스에서 실행 되는 부분적으로 신뢰할 수 있는 코드를 추적 하려면 추적 수신기를 추가 하지 마세요.To trace partially trusted code that is running in a sandbox in Visual Studio, do not add trace listeners. 대신 보기의 TraceDebug 의 메시지를 출력 창.Instead, view the Trace and Debug messages in the Output window.

합니다 Trace 클래스의 수준을 가져오거나 설정 하는 속성을 제공 IndentIndentSize, 여부와 AutoFlush 기록할 때마다 합니다.The Trace class provides properties to get or set the level of Indent, the IndentSize, and whether to AutoFlush after each write.

설정 하는 AutoFlush 하 고 IndentSize 에 대 한 Trace, 애플리케이션의 이름에 해당 하는 구성 파일을 편집할 수 있습니다.To set the AutoFlush and IndentSize for Trace, you can edit the configuration file that corresponds to the name of your application. 다음 예제와 같이 구성 파일의 형식은 해야 합니다.The configuration file should be formatted like the following example:

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

합니다 ConditionalAttribute 특성의 메서드에 적용 됩니다 Trace합니다.The ConditionalAttribute attribute is applied to the methods of Trace. 지 원하는 컴파일러 ConditionalAttribute "TRACE" 조건부 컴파일 기호로 정의 되어 있지 않으면 이러한 메서드에 대 한 호출을 무시 합니다.Compilers that support ConditionalAttribute ignore calls to these methods unless "TRACE" is defined as a conditional compilation symbol. 확인 하는 컴파일러의 설명서를 참조 하는지 여부를 ConditionalAttribute 지원 됩니다 및 조건부 컴파일 기호를 정의 하기 위한 구문.Refer to a compiler's documentation to determine whether ConditionalAttribute is supported and the syntax for defining a conditional compilation symbol.

참고

기본적으로 Visual Studio 프로젝트에서 "디버그" 조건부 컴파일 기호는 디버그 빌드에 대해 정의 됩니다 하 고 "TRACE" 기호를 모두 디버그 및 릴리스 빌드에 대해 정의 됩니다.In Visual Studio projects, by default, the "DEBUG" conditional compilation symbol is defined for debug builds, and the "TRACE" symbol is defined for both debug and release builds. 이 동작을 사용 하지 않도록 설정 하는 방법에 대 한 내용은 Visual Studio 설명서를 참조 하세요.For information about how to disable this behavior, see the Visual Studio documentation.

C#의 "TRACE" 조건부 컴파일 기호를 정의 하려면 다음을 추가 합니다 /d:TRACE 명령줄을 사용 하 여 코드를 컴파일할 때 컴파일러 명령줄 옵션 또는 추가 #define TRACE 파일의 맨 위로 이동 합니다.To define the "TRACE" conditional compilation symbol in C#, add the /d:TRACE option to the compiler command line when you compile your code using a command line, or add #define TRACE to the top of your file. Visual basic의 경우 추가 합니다 /d:TRACE=True 컴파일러 명령줄 옵션 또는 추가 #Const TRACE=True 파일입니다.In Visual Basic, add the /d:TRACE=True option to the compiler command line or add #Const TRACE=True to the file.

ConditionalAttribute c + + 컴파일러에서 지원 되지 않습니다.ConditionalAttribute is not supported by the C++ compiler. 해당 기능을 제공 하려면의 메서드를 호출 묶어야 Trace#if defined(TRACE) ... #endif 블록 및 추가 합니다 /DTRACE 컴파일러 명령줄 옵션 또는 추가 #define TRACE 파일에.To provide equivalent functionality, you must enclose calls to the methods of Trace in an #if defined(TRACE) ... #endif block, and add the /DTRACE option to the compiler command line or add #define TRACE to the file.

속성

AutoFlush

각 쓰기 직후에 Flush()에서 Listeners를 호출해야 하는지 여부를 가져오거나 설정합니다.Gets or sets whether Flush() should be called on the Listeners after every write.

CorrelationManager

이 추적에 대한 스레드의 상관 관계 관리자를 가져옵니다.Gets the correlation manager for the thread for this trace.

IndentLevel

들여쓰기 수준을 가져오거나 설정합니다.Gets or sets the indent level.

IndentSize

들여쓰기의 공백 수를 가져오거나 설정합니다.Gets or sets the number of spaces in an indent.

Listeners

추적 출력을 모니터링하는 수신기 컬렉션을 가져옵니다.Gets the collection of listeners that is monitoring the trace output.

UseGlobalLock

전역 잠금을 사용해야 할지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the global lock should be used.

메서드

Assert(Boolean)

조건을 확인합니다. 조건이 false이면 호출 스택을 보여주는 메시지 상자를 표시합니다.Checks for a condition; if the condition is false, displays a message box that shows the call stack.

Assert(Boolean, String)

조건을 확인합니다. 조건이 false이면 지정된 메시지를 출력하고 호출 스택을 보여주는 메시지 상자를 표시합니다.Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

Assert(Boolean, String, String)

조건을 확인합니다. 조건이 false이면 지정된 2개의 메시지를 출력하고 호출 스택을 보여주는 메시지 상자를 표시합니다.Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

Close()

출력 버퍼를 플러시한 다음 Listeners를 닫습니다.Flushes the output buffer, and then closes the Listeners.

Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
Fail(String)

지정한 오류 메시지를 내보냅니다.Emits the specified error message.

Fail(String, String)

오류 메시지와 자세한 오류 메시지를 내보냅니다.Emits an error message, and a detailed error message.

Flush()

출력 버퍼를 플러시하고 버퍼링된 데이터를 Listeners에 쓰도록 합니다.Flushes the output buffer, and causes buffered data to be written to the Listeners.

GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
Indent()

현재 IndentLevel을 1만큼 증가시킵니다.Increases the current IndentLevel by one.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
Refresh()

추적 구성 데이터를 새로 고칩니다.Refreshes the trace configuration data.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)
TraceError(String)

지정된 메시지를 사용하여 Listeners 컬렉션의 추적 수신기에 오류 메시지를 씁니다.Writes an error message to the trace listeners in the Listeners collection using the specified message.

TraceError(String, Object[])

지정된 개체 배열과 서식 지정 정보를 사용하여 Listeners 컬렉션의 추적 수신기에 오류 메시지를 씁니다.Writes an error message to the trace listeners in the Listeners collection using the specified array of objects and formatting information.

TraceInformation(String)

지정된 메시지를 사용하여 Listeners 컬렉션의 추적 수신기에 알림 메시지를 씁니다.Writes an informational message to the trace listeners in the Listeners collection using the specified message.

TraceInformation(String, Object[])

지정된 개체 배열과 서식 지정 정보를 사용하여 Listeners 컬렉션의 추적 수신기에 알림 메시지를 씁니다.Writes an informational message to the trace listeners in the Listeners collection using the specified array of objects and formatting information.

TraceWarning(String)

지정된 메시지를 사용하여 Listeners 컬렉션의 추적 수신기에 경고 메시지를 씁니다.Writes a warning message to the trace listeners in the Listeners collection using the specified message.

TraceWarning(String, Object[])

지정된 개체 배열과 서식 지정 정보를 사용하여 Listeners 컬렉션의 추적 수신기에 경고 메시지를 씁니다.Writes a warning message to the trace listeners in the Listeners collection using the specified array of objects and formatting information.

Unindent()

현재 IndentLevel을 1만큼 감소시킵니다.Decreases the current IndentLevel by one.

Write(Object)

ToString() 컬렉션의 추적 수신기에 개체의 Listeners 메서드 값을 씁니다.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

Write(Object, String)

ToString() 컬렉션의 추적 수신기에 개체의 Listeners 메서드 값 및 범주 이름을 씁니다.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

Write(String)

Listeners 컬렉션의 추적 수신기에 메시지를 씁니다.Writes a message to the trace listeners in the Listeners collection.

Write(String, String)

Listeners 컬렉션의 추적 수신기에 범주 이름 및 메시지를 씁니다.Writes a category name and a message to the trace listeners in the Listeners collection.

WriteIf(Boolean, Object)

조건이 true이면 ToString() 컬렉션의 추적 수신기에 개체의 Listeners 메서드 값을 씁니다.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, Object, String)

조건이 true이면 ToString() 컬렉션의 추적 수신기에 개체의 Listeners 메서드 값 및 범주 이름을 씁니다.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, String)

조건이 true이면 Listeners 컬렉션의 추적 수신기에 메시지를 씁니다.Writes a message to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, String, String)

조건이 true이면 Listeners 컬렉션의 추적 수신기에 범주 이름 및 메시지를 씁니다.Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.

WriteLine(Object)

ToString() 컬렉션의 추적 수신기에 개체의 Listeners 메서드 값을 씁니다.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(Object, String)

ToString() 컬렉션의 추적 수신기에 개체의 Listeners 메서드 값 및 범주 이름을 씁니다.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(String)

Listeners 컬렉션의 추적 수신기에 메시지를 씁니다.Writes a message to the trace listeners in the Listeners collection.

WriteLine(String, String)

Listeners 컬렉션의 추적 수신기에 범주 이름 및 메시지를 씁니다.Writes a category name and message to the trace listeners in the Listeners collection.

WriteLineIf(Boolean, Object)

조건이 true이면 ToString() 컬렉션의 추적 수신기에 개체의 Listeners 메서드 값을 씁니다.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, Object, String)

조건이 true이면 ToString() 컬렉션의 추적 수신기에 개체의 Listeners 메서드 값 및 범주 이름을 씁니다.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, String)

조건이 true이면 Listeners 컬렉션의 추적 수신기에 메시지를 씁니다.Writes a message to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, String, String)

조건이 true이면 Listeners 컬렉션의 추적 수신기에 범주 이름 및 메시지를 씁니다.Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.

보안

SecurityPermission
에 관리 되지 않는 코드를 사용 하 여 작동 합니다.for operating with unmanaged code. 보안 동작: Demand합니다.Security action: Demand. 연결 된 열거형: UnmanagedCodeAssociated enumeration: UnmanagedCode

적용 대상

스레드 보안

이 형식은 스레드로부터 안전합니다.This type is thread safe.

추가 정보