Debug 클래스

정의

코드 디버깅에 도움이 되는 메서드 및 속성들을 제공합니다.Provides a set of methods and properties that help debug your code.

public ref class Debug abstract sealed
public ref class Debug sealed
public static class Debug
public sealed class Debug
type Debug = class
Public Class Debug
Public NotInheritable Class Debug
상속
Debug

예제

다음 예제에서는 Debug 를 사용 하 여 프로그램 실행의 시작과 끝을 표시 합니다.The following example uses Debug to indicate the beginning and end of a program's execution. 또한이 예제에서는 IndentUnindent 를 사용 하 여 추적 출력을 구분 합니다.The example also uses Indent and Unindent to distinguish the tracing output.

// Specify /DDEBUG when compiling.

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

int main( void )
{
   #if defined(DEBUG)
   Debug::Listeners->Add( gcnew TextWriterTraceListener( Console::Out ) );
   Debug::AutoFlush = true;
   Debug::Indent();
   Debug::WriteLine( "Entering Main" );
   #endif
   Console::WriteLine( "Hello World." );
   #if defined(DEBUG)
   Debug::WriteLine( "Exiting Main" );
   Debug::Unindent();
   #endif
   return 0;
}
// Specify /d:DEBUG when compiling.

using System;
using System.Data;
using System.Diagnostics;

class Test
{
    static void Main()
    {
       Debug.Listeners.Add(new TextWriterTraceListener(Console.Out));
       Debug.AutoFlush = true;
       Debug.Indent();
       Debug.WriteLine("Entering Main");
       Console.WriteLine("Hello World.");
       Debug.WriteLine("Exiting Main");
       Debug.Unindent();
    }
}
' Specify /d:DEBUG=True when compiling.

Imports System.Data
Imports System.Diagnostics

Class Test

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

설명

클래스의 메서드를 사용 하 여 디버깅 정보를 인쇄 하 고 어설션을 사용 하 여 논리를 확인 하는 경우 Debug 배송 제품의 성능 및 코드 크기에 영향을 주지 않고 코드를 보다 강력 하 게 만들 수 있습니다.If you use methods in the Debug class to print debugging information and check your logic with assertions, you can make your code more robust without impacting the performance and code size of your shipping product.

이 클래스는 Assert 대화 상자를 표시 하 고 항상 실패 하는 어설션을 내보내는 메서드를 제공 합니다.This class provides methods to display an Assert dialog box, and to emit an assertion that will always fail. 이 클래스는, 및 변형에서 쓰기 메서드 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 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컬렉션은 및 클래스 모두에서 공유 됩니다. 두 Debug Trace 클래스 중 하나에 추적 수신기를 추가 하면 수신기가 둘 다에 추가 됩니다.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, the DefaultTraceListener class emits trace output.

참고

추적 수신기를 컬렉션에 추가 하면 추적 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. 블록의 메서드에 호출을 추가 하 여 Debug try / catch 추적 수신기의 모든 예외를 검색 하 고 처리 하는 것이 유용할 수 있습니다.It may be useful to place calls to the Debug methods in try/catch blocks to detect and handle any exceptions from trace listeners.

메서드 또는 속성을 사용 하 여 들여쓰기 수준을 수정할 수 있습니다 Indent IndentLevel .You can modify the level of indentation using the Indent method or the IndentLevel property. 들여쓰기 간격을 수정 하려면 속성을 사용 IndentSize 합니다.To modify the indent spacing, use the IndentSize property. 속성을로 설정 하 여 각 쓰기 후 출력 버퍼를 자동으로 플러시하지 여부를 지정할 수 있습니다 AutoFlush true .You can specify whether to automatically flush the output buffer after each write by setting the AutoFlush property to true.

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

<configuration>  
  <system.diagnostics>  
    <trace autoflush="true" indentsize="7" />  
  </system.diagnostics>  
</configuration>  

ConditionalAttribute특성은의 메서드에 적용 됩니다 Debug .The ConditionalAttribute attribute is applied to the methods of Debug. ConditionalAttribute"DEBUG"가 조건부 컴파일 기호로 정의 되지 않은 경우를 지 원하는 컴파일러는 이러한 메서드에 대 한 호출을 무시 합니다.Compilers that support ConditionalAttribute ignore calls to these methods unless "DEBUG" 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 c # 및 Visual Basic 프로젝트에서 기본적으로 디버그 빌드에 대해 "디버그" 조건부 컴파일 기호가 정의 되 고 디버그 및 릴리스 빌드 모두에 대해 "TRACE" 기호가 정의 됩니다.In Visual Studio C# and Visual Basic 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. Visual C++의 조건부 디버깅에 대 한 자세한 내용은 Debug 클래스 (c + +/cli)를 참조 하세요.For information about conditional debugging in Visual C++, see Debug Class (C++/CLI).

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

속성

AutoFlush

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

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 debug output.

메서드

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.

Assert(Boolean, String, String, Object[])

조건을 확인합니다. 조건이 false이면 두 개의 메시지(단순 및 서식 있는 메시지)를 출력하고 호출 스택을 보여 주는 메시지 상자를 표시합니다.Checks for a condition; if the condition is false, outputs two messages (simple and formatted) and displays a message box that shows the call stack.

Close()

출력 버퍼를 플러시한 다음 각 Listeners에 대해 Close 메서드를 호출합니다.Flushes the output buffer and then calls the Close method on each of the Listeners.

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 write to the Listeners collection.

Indent()

현재 IndentLevel 이 1씩 증가합니다.Increases the current IndentLevel by one.

Print(String)

Listeners 컬렉션의 추적 수신기에 메시지를 쓰고 뒤에 줄 종결자를 붙입니다.Writes a message followed by a line terminator to the trace listeners in the Listeners collection.

Print(String, Object[])

Listeners 컬렉션의 추적 수신기에 서식이 지정된 문자열을 쓰고 뒤에 줄 종결자를 붙입니다.Writes a formatted string followed by a line terminator to the trace listeners in the Listeners collection.

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 message to the trace listeners in the Listeners collection.

WriteIf(Boolean, Object)

조건이 ToString() 인 경우 Listeners 컬렉션의 추적 수신기에 개체의 true메서드 값을 씁니다.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)

조건이 ToString() 인 경우 Listeners 컬렉션의 추적 수신기에 범주 이름 및 개체의 true메서드 값을 씁니다.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)

조건이 Listeners 이면 true컬렉션의 추적 수신기에 범주 이름 및 메시지를 씁니다.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 followed by a line terminator to the trace listeners in the Listeners collection.

WriteLine(String, Object[])

Listeners 컬렉션의 추적 수신기에 서식이 지정된 메시지를 쓰고 뒤에 줄 종결자를 붙입니다.Writes a formatted message followed by a line terminator 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)

조건이 ToString() 인 경우 Listeners 컬렉션의 추적 수신기에 개체의 true메서드 값을 씁니다.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)

조건이 ToString() 인 경우 Listeners 컬렉션의 추적 수신기에 범주 이름 및 개체의 true메서드 값을 씁니다.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)

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

적용 대상

스레드 보안

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

추가 정보