다음을 통해 공유


Debug.WriteIf 메서드

정의

조건이 true경우 디버그에 대한 정보를 Listeners 컬렉션의 추적 수신기에 씁니다.

오버로드

WriteIf(Boolean, Debug+WriteIfInterpolatedStringHandler)

condition true경우 범주 이름과 메시지를 Listeners 컬렉션의 추적 수신기에 씁니다.

WriteIf(Boolean, Object)

조건이 true경우 개체의 ToString() 메서드 값을 Listeners 컬렉션의 추적 수신기에 씁니다.

WriteIf(Boolean, String)

조건이 true경우 Listeners 컬렉션의 추적 수신기에 메시지를 씁니다.

WriteIf(Boolean, Debug+WriteIfInterpolatedStringHandler, String)

지정된 조건이 true경우 범주 이름과 메시지를 Listeners 컬렉션의 추적 수신기에 씁니다.

WriteIf(Boolean, Object, String)

조건이 true경우 범주 이름과 개체의 ToString() 메서드 값을 Listeners 컬렉션의 추적 수신기에 씁니다.

WriteIf(Boolean, String, String)

조건이 true경우 범주 이름과 메시지를 Listeners 컬렉션의 추적 수신기에 씁니다.

WriteIf(Boolean, Debug+WriteIfInterpolatedStringHandler)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

condition true경우 범주 이름과 메시지를 Listeners 컬렉션의 추적 수신기에 씁니다.

public:
 static void WriteIf(bool condition, System::Diagnostics::Debug::WriteIfInterpolatedStringHandler % message);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteIf (bool condition, ref System.Diagnostics.Debug.WriteIfInterpolatedStringHandler message);
[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteIf : bool * WriteIfInterpolatedStringHandler -> unit
Public Shared Sub WriteIf (condition As Boolean, ByRef message As Debug.WriteIfInterpolatedStringHandler)

매개 변수

condition
Boolean

평가할 조건식입니다. 조건이 true경우 값은 컬렉션의 추적 수신기에 기록됩니다.

message
Debug.WriteIfInterpolatedStringHandler

condition true경우 쓸 메시지입니다.

특성

설명

이 오버로드는 성능을 향상시키기 위해 .NET 6에 도입되었습니다. String 매개 변수를 사용하는 오버로드와 비교하여 이 오버로드는 메시지가 필요한 경우에만 보간된 문자열 서식 항목을 평가합니다.

기본적으로 출력은 DefaultTraceListener인스턴스에 기록됩니다.

category 매개 변수를 사용하여 출력 메시지를 그룹화합니다.

이 메서드는 추적 수신기의 Write 메서드를 호출합니다.

추가 정보

적용 대상

WriteIf(Boolean, Object)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

조건이 true경우 개체의 ToString() 메서드 값을 Listeners 컬렉션의 추적 수신기에 씁니다.

public:
 static void WriteIf(bool condition, System::Object ^ value);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteIf (bool condition, object value);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteIf (bool condition, object? value);
[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteIf : bool * obj -> unit
Public Shared Sub WriteIf (condition As Boolean, value As Object)

매개 변수

condition
Boolean

평가할 조건식입니다. 조건이 true경우 값은 컬렉션의 추적 수신기에 기록됩니다.

value
Object

이름이 Listeners전송되는 개체입니다.

특성

예제

다음 예제에서는 이름이 generalSwitchTraceSwitch 만듭니다. 이 스위치는 코드 샘플 외부에서 설정됩니다.

스위치가 TraceLevelError 이상으로 설정된 경우 이 예제에서는 값 매개 변수의 이름을 Listeners출력합니다. Listeners 컬렉션에 수신기를 추가하는 방법에 대한 자세한 내용은 TraceListenerCollection 클래스를 참조하세요.

그런 다음 TraceLevelVerbose설정하면 첫 번째 메시지와 동일한 줄에 메시지를 출력합니다. 줄 종결자는 두 번째 메시지를 따릅니다.

   // Class-level declaration.
   // Create a TraceSwitch.
   static TraceSwitch^ generalSwitch = 
      gcnew TraceSwitch( "General","Entire Application" );

public:
   static void MyErrorMethod( Object^ myObject )
   {
      // Write the message if the TraceSwitch level is set to Error or higher.
      #if defined(DEBUG)
      Debug::WriteIf( generalSwitch->TraceError, myObject );
      
      // Write a second message if the TraceSwitch level is set to Verbose.
      Debug::WriteLineIf( generalSwitch->TraceVerbose, 
         " is not a valid value for this method." );
      #endif
   }
// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

static public void MyErrorMethod(Object myObject)
{
    // Write the message if the TraceSwitch level is set to Error or higher.
    Debug.WriteIf(generalSwitch.TraceError, myObject);

    // Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteLineIf(generalSwitch.TraceVerbose, " is not a valid value for this method.");
}
' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod(myObject As Object)
    ' Write the message if the TraceSwitch level is set to Error or higher.
    Debug.WriteIf(generalSwitch.TraceError, myObject)
    
    ' Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteLineIf(generalSwitch.TraceVerbose, " is not a valid value for this method.")
End Sub

설명

기본적으로 출력은 DefaultTraceListener인스턴스에 기록됩니다.

이 메서드는 추적 수신기의 Write 메서드를 호출합니다.

상속자 참고

WriteIf(Boolean, String) 문을 사용하는 대신 If...Then 문을 사용하여 애플리케이션 계측의 성능 저하를 최소화할 수 있습니다. 다음 두 코드 예제에서는 동일한 디버깅 메시지를 보냅니다. 그러나 추적이 해제된 경우 첫 번째 예제는 훨씬 빠릅니다. mySwitch.TraceErrorfalse평가되는 경우 Write(String)호출하지 않기 때문입니다. 두 번째 예제에서는 mySwitch.TraceErrorfalse 추적 출력이 생성되지 않는 경우에도 항상 WriteIf(Boolean, String)호출합니다. 이로 인해 임의로 복잡한 코드를 불필요하게 실행할 수 있습니다.

첫 번째 예제:

if(mySwitch.TraceError)
    Debug.Write("aNumber = " + aNumber + " out of range");

두 번째 예제:

Debug.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

추가 정보

적용 대상

WriteIf(Boolean, String)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

조건이 true경우 Listeners 컬렉션의 추적 수신기에 메시지를 씁니다.

public:
 static void WriteIf(bool condition, System::String ^ message);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteIf (bool condition, string message);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteIf (bool condition, string? message);
[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteIf : bool * string -> unit
Public Shared Sub WriteIf (condition As Boolean, message As String)

매개 변수

condition
Boolean

평가할 조건식입니다. 조건이 true경우 메시지는 컬렉션의 추적 수신기에 기록됩니다.

message
String

쓸 메시지입니다.

특성

예제

다음 예제에서는 이름이 generalSwitchTraceSwitch 만듭니다. 이 스위치는 코드 샘플 외부에서 설정됩니다.

스위치가 TraceLevelError 이상으로 설정된 경우 예제에서는 첫 번째 오류 메시지를 Listeners출력합니다. Listeners 컬렉션에 수신기를 추가하는 방법에 대한 자세한 내용은 TraceListenerCollection 클래스를 참조하세요.

그런 다음 TraceLevelVerbose설정하면 첫 번째 메시지와 동일한 줄에 두 번째 오류 메시지가 출력됩니다. 줄 종결자는 두 번째 메시지를 따릅니다.

   // Class-level declaration.
   // Create a TraceSwitch.
   static TraceSwitch^ generalSwitch = 
      gcnew TraceSwitch( "General","Entire Application" );

public:
   static void MyErrorMethod()
   {
      // Write the message if the TraceSwitch level is set to Error or higher.
      #if defined(DEBUG)
      Debug::WriteIf( generalSwitch->TraceError, "My error message. " );
      
      // Write a second message if the TraceSwitch level is set to Verbose.
      Debug::WriteIf( generalSwitch->TraceVerbose, 
         "My second error message." );
      #endif
   }
// Class-level declaration.
// Create a TraceSwitch.
TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

static void MyErrorMethod()
{
    // Write the message if the TraceSwitch level is set to Error or higher.
    Debug.WriteIf(generalSwitch.TraceError, "My error message. ");

    // Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteIf(generalSwitch.TraceVerbose, "My second error message.");
}
' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod()
    ' Write the message if the TraceSwitch level is set to Error or higher.
    Debug.WriteIf(generalSwitch.TraceError, "My error message. ")
    
    ' Write a second message if the TraceSwitch level is set to Verbose.
    Debug.WriteIf(generalSwitch.TraceVerbose, "My second error message.")
End Sub

설명

기본적으로 출력은 DefaultTraceListener인스턴스에 기록됩니다.

이 메서드는 추적 수신기의 Write 메서드를 호출합니다.

상속자 참고

WriteIf(Boolean, String) 문을 사용하는 대신 If...Then 문을 사용하여 애플리케이션 계측의 성능 저하를 최소화할 수 있습니다. 다음 두 코드 예제에서는 동일한 디버깅 메시지를 보냅니다. 그러나 추적이 해제된 경우 첫 번째 예제는 훨씬 빠릅니다. mySwitch.TraceErrorfalse평가되는 경우 Write(String)호출하지 않기 때문입니다. 두 번째 예제에서는 mySwitch.TraceErrorfalse 추적 출력이 생성되지 않는 경우에도 항상 WriteIf(Boolean, String)호출합니다. 이로 인해 임의로 복잡한 코드를 불필요하게 실행할 수 있습니다.

첫 번째 예제:

if(mySwitch.TraceError)
    Debug.Write("aNumber = " + aNumber + " out of range");

두 번째 예제:

Debug.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

추가 정보

적용 대상

WriteIf(Boolean, Debug+WriteIfInterpolatedStringHandler, String)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

지정된 조건이 true경우 범주 이름과 메시지를 Listeners 컬렉션의 추적 수신기에 씁니다.

public:
 static void WriteIf(bool condition, System::Diagnostics::Debug::WriteIfInterpolatedStringHandler % message, System::String ^ category);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteIf (bool condition, ref System.Diagnostics.Debug.WriteIfInterpolatedStringHandler message, string? category);
[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteIf : bool * WriteIfInterpolatedStringHandler * string -> unit
Public Shared Sub WriteIf (condition As Boolean, ByRef message As Debug.WriteIfInterpolatedStringHandler, category As String)

매개 변수

condition
Boolean

평가할 조건식입니다. 조건이 true경우 메시지는 컬렉션의 추적 수신기에 기록됩니다.

message
Debug.WriteIfInterpolatedStringHandler

쓸 메시지입니다.

category
String

출력을 구성하는 데 사용되는 범주 이름입니다.

특성

설명

이 오버로드는 성능을 향상시키기 위해 .NET 6에 도입되었습니다. String 매개 변수를 사용하는 오버로드와 비교하여 이 오버로드는 메시지가 필요한 경우에만 보간된 문자열 서식 항목을 평가합니다.

기본적으로 출력은 DefaultTraceListener인스턴스에 기록됩니다.

category 매개 변수를 사용하여 출력 메시지를 그룹화합니다.

이 메서드는 추적 수신기의 Write 메서드를 호출합니다.

추가 정보

적용 대상

WriteIf(Boolean, Object, String)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

조건이 true경우 범주 이름과 개체의 ToString() 메서드 값을 Listeners 컬렉션의 추적 수신기에 씁니다.

public:
 static void WriteIf(bool condition, System::Object ^ value, System::String ^ category);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteIf (bool condition, object value, string category);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteIf (bool condition, object? value, string? category);
[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteIf : bool * obj * string -> unit
Public Shared Sub WriteIf (condition As Boolean, value As Object, category As String)

매개 변수

condition
Boolean

평가할 조건식입니다. 조건이 true경우 범주 이름과 값은 컬렉션의 추적 수신기에 기록됩니다.

value
Object

이름이 Listeners전송되는 개체입니다.

category
String

출력을 구성하는 데 사용되는 범주 이름입니다.

특성

예제

다음 예제에서는 이름이 generalSwitchTraceSwitch 만듭니다. 이 스위치는 코드 샘플 외부에서 설정됩니다.

스위치가 TraceLevelVerbose설정된 경우 예제에서는 myObject 이름과 categoryListeners출력합니다. Listeners 컬렉션에 수신기를 추가하는 방법에 대한 자세한 내용은 TraceListenerCollection 클래스를 참조하세요.

그런 다음, TraceLevelError 이상으로 설정된 경우 예제에서는 첫 번째 메시지와 동일한 줄에 두 번째 오류 메시지를 출력합니다. 줄 종결자는 두 번째 메시지를 따릅니다.

   // Class-level declaration.
   // Create a TraceSwitch.
   static TraceSwitch^ generalSwitch = 
      gcnew TraceSwitch( "General","Entire Application" );

public:
   static void MyErrorMethod( Object^ myObject, String^ category )
   {
      // Write the message if the TraceSwitch level is set to Error or higher.
      #if defined(DEBUG)
      Debug::WriteIf( generalSwitch->TraceVerbose, myObject, category );
      
      // Write a second message if the TraceSwitch level is set to Verbose.
      Debug::WriteLineIf( generalSwitch->TraceError, 
         " Object is not valid for this category." );
      #endif
   }
// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

static public void MyErrorMethod(Object myObject, string category)
{
    // Write the message if the TraceSwitch level is set to Verbose.
    Debug.WriteIf(generalSwitch.TraceVerbose, myObject, category);

    // Write a second message if the TraceSwitch level is set to Error or higher.
    Debug.WriteLineIf(generalSwitch.TraceError, " Object is not valid for this category.");
}
' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod(myObject As Object, category As String)
    ' Write the message if the TraceSwitch level is set to Verbose.
    Debug.WriteIf(generalSwitch.TraceVerbose, myObject, category)
    
    ' Write a second message if the TraceSwitch level is set to Error or higher.
    Debug.WriteLineIf(generalSwitch.TraceError, " Object is not valid for this category.")
End Sub

설명

기본적으로 출력은 DefaultTraceListener인스턴스에 기록됩니다.

category 매개 변수를 사용하여 출력 메시지를 그룹화할 수 있습니다.

이 메서드는 추적 수신기의 Write 메서드를 호출합니다.

상속자 참고

WriteIf(Boolean, String) 문을 사용하는 대신 If...Then 문을 사용하여 애플리케이션 계측의 성능 저하를 최소화할 수 있습니다. 다음 두 코드 예제에서는 동일한 디버깅 메시지를 보냅니다. 그러나 추적이 해제된 경우 첫 번째 예제는 훨씬 빠릅니다. mySwitch.TraceErrorfalse평가되는 경우 Write(String)호출하지 않기 때문입니다. 두 번째 예제에서는 mySwitch.TraceErrorfalse 추적 출력이 생성되지 않는 경우에도 항상 WriteIf(Boolean, String)호출합니다. 이로 인해 임의로 복잡한 코드를 불필요하게 실행할 수 있습니다.

첫 번째 예제:

if(mySwitch.TraceError)
    Debug.Write("aNumber = " + aNumber + " out of range");

두 번째 예제:

Debug.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

추가 정보

적용 대상

WriteIf(Boolean, String, String)

Source:
Debug.cs
Source:
Debug.cs
Source:
Debug.cs

조건이 true경우 범주 이름과 메시지를 Listeners 컬렉션의 추적 수신기에 씁니다.

public:
 static void WriteIf(bool condition, System::String ^ message, System::String ^ category);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteIf (bool condition, string message, string category);
[System.Diagnostics.Conditional("DEBUG")]
public static void WriteIf (bool condition, string? message, string? category);
[<System.Diagnostics.Conditional("DEBUG")>]
static member WriteIf : bool * string * string -> unit
Public Shared Sub WriteIf (condition As Boolean, message As String, category As String)

매개 변수

condition
Boolean

평가할 조건식입니다. 조건이 true경우 범주 이름과 메시지는 컬렉션의 추적 수신기에 기록됩니다.

message
String

쓸 메시지입니다.

category
String

출력을 구성하는 데 사용되는 범주 이름입니다.

특성

예제

다음 예제에서는 이름이 generalSwitchTraceSwitch 만듭니다. 이 스위치는 코드 샘플 외부에서 설정됩니다.

스위치가 TraceLevelVerbose설정된 경우 예제에서는 첫 번째 오류 메시지를 Listeners출력합니다. Listeners 컬렉션에 수신기를 추가하는 방법에 대한 자세한 내용은 TraceListenerCollection 클래스를 참조하세요.

그런 다음, TraceLevelError 이상으로 설정된 경우 예제에서는 첫 번째 메시지와 동일한 줄에 두 번째 오류 메시지를 출력합니다. 줄 종결자는 두 번째 메시지를 따릅니다.

   // Class-level declaration.
   // Create a TraceSwitch.
   static TraceSwitch^ generalSwitch = 
      gcnew TraceSwitch( "General","Entire Application" );

public:
   static void MyErrorMethod( Object^ myObject, String^ category )
   {
      // Write the message if the TraceSwitch level is set to Error or higher.
      #if defined(DEBUG)
      Debug::WriteIf( generalSwitch->TraceVerbose, String::Concat( myObject, 
         " is not a valid object for category: " ), category );
      
      // Write a second message if the TraceSwitch level is set to Verbose.
      Debug::WriteLineIf( generalSwitch->TraceError, 
         " Please use a different category." );
      #endif
   }
// Class-level declaration.
// Create a TraceSwitch.
static TraceSwitch generalSwitch = new TraceSwitch("General", "Entire Application");

static public void MyErrorMethod(Object myObject, string category)
{
    // Write the message if the TraceSwitch level is set to Verbose.
    Debug.WriteIf(generalSwitch.TraceVerbose, myObject.ToString() +
       " is not a valid object for category: ", category);

    // Write a second message if the TraceSwitch level is set to Error or higher.
    Debug.WriteLineIf(generalSwitch.TraceError, " Please use a different category.");
}
' Class-level declaration.
' Create a TraceSwitch.
Private Shared generalSwitch As New TraceSwitch("General", "Entire Application")


Public Shared Sub MyErrorMethod(myObject As Object, category As String)
    ' Write the message if the TraceSwitch level is set to Verbose.
    Debug.WriteIf(generalSwitch.TraceVerbose, myObject.ToString() & _
        " is not a valid object for category: ", category)
    
    ' Write a second message if the TraceSwitch level is set to Error or higher.
    Debug.WriteLineIf(generalSwitch.TraceError, " Please use a different category.")
End Sub

설명

기본적으로 출력은 DefaultTraceListener인스턴스에 기록됩니다.

category 매개 변수를 사용하여 출력 메시지를 그룹화할 수 있습니다.

이 메서드는 추적 수신기의 TraceListener.Write 메서드를 호출합니다.

상속자 참고

WriteIf(Boolean, String) 문을 사용하는 대신 If...Then 문을 사용하여 애플리케이션 계측의 성능 저하를 최소화할 수 있습니다. 다음 두 코드 예제에서는 동일한 디버깅 메시지를 보냅니다. 그러나 추적이 해제된 경우 첫 번째 예제는 훨씬 빠릅니다. mySwitch.TraceErrorfalse평가되는 경우 Write(String)호출하지 않기 때문입니다. 두 번째 예제에서는 mySwitch.TraceErrorfalse 추적 출력이 생성되지 않는 경우에도 항상 WriteIf(Boolean, String)호출합니다. 이로 인해 임의로 복잡한 코드를 불필요하게 실행할 수 있습니다.

첫 번째 예제:

if(mySwitch.TraceError)
    Debug.Write("aNumber = " + aNumber + " out of range");

두 번째 예제:

Debug.WriteIf(mySwitch.TraceError, "aNumber = " + aNumber + " out of range");

추가 정보

적용 대상