Trace.Assert 메서드

참조

정의

네임스페이스:: System.Diagnostics

어셈블리:: System.Diagnostics.TraceSource.dll

어셈블리:: System.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

조건을 확인합니다. 조건이 false이면 메시지를 출력하고 호출 스택을 보여주는 메시지 상자를 표시합니다.

오버로드

Assert(Boolean)	조건을 확인합니다. 조건이 `false`이면 호출 스택을 보여주는 메시지 상자를 표시합니다.
Assert(Boolean, String)	조건을 확인합니다. 조건이 `false`이면 지정된 메시지를 출력하고 호출 스택을 보여주는 메시지 상자를 표시합니다.
Assert(Boolean, String, String)	조건을 확인합니다. 조건이 `false`이면 지정된 2개의 메시지를 출력하고 호출 스택을 보여주는 메시지 상자를 표시합니다.

Assert(Boolean)

Source:: Trace.cs

Source:: Trace.cs

Source:: Trace.cs

조건을 확인합니다. 조건이 false이면 호출 스택을 보여주는 메시지 상자를 표시합니다.

public:
 static void Assert(bool condition);

[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition);

[<System.Diagnostics.Conditional("TRACE")>]
static member Assert : bool -> unit

Public Shared Sub Assert (condition As Boolean)

매개 변수

condition: Boolean

계산할 조건부 식입니다. 조건이 true이면 실패 메시지가 전송되지 않고 메시지 상자가 표시되지 않습니다.

특성: ConditionalAttribute

예제

다음 예제에서는 배열에 대한 인덱스 를 만듭니다. 그런 다음 인덱스의 값을 설정하는 일부 작업이 수행됩니다. 다음으로 코드는 를 호출 Assert 하여 인덱스 값이 유효한지 확인합니다. 유효하지 않으면 호출 Assert 스택이 출력됩니다.

protected:
   // Create an index for an array.
   int index;

   void Method()
   {
      // Perform some action that sets the index.
      // Test that the index value is valid.
      #if defined(TRACE)
      Trace::Assert( index > -1 );
      #endif
   }

// Create an index for an array.
int index;

void Method()
{
    // Perform some action that sets the index.

    // Test that the index value is valid.
    Trace.Assert(index > -1);
}

' Create an index for an array.
Protected index As Integer    

Protected Sub Method()
    ' Perform some action that sets the index.
    ' Test that the index value is valid. 
    Trace.Assert(index > -1)
End Sub

설명

릴리스 빌드에서 Trace.Assert 어설션을 수행하려는 경우 메서드를 사용합니다. 메서드는 Debug.Assert 디버그 빌드에서만 작동합니다. 자세한 내용은 관리 코드의 어설션을 참조하세요.

일반적으로 메서드는 Assert(Boolean) 프로그램 개발 중에 논리 오류를 식별하는 데 사용됩니다. Assert(Boolean) 는 조건을 평가합니다. 결과가 false인 경우 컬렉션에 실패 메시지를 Listeners 보냅니다. 컬렉션에 를 TraceListener 추가하거나 컬렉션에서 Listeners 제거하여 이 동작을 사용자 지정할 수 있습니다.

사용자 인터페이스 모드로 실행 되는 애플리케이션 파일 및 줄 번호를 사용 하 여 호출 스택을 보여 주는 메시지 상자가 표시 됩니다. 메시지 상자에는 중단, 다시 시도 및 무시의 세 가지 단추가 포함되어 있습니다. 클릭 하 여 중단 단추 애플리케이션을 종료 합니다. 클릭 다시 시도 애플리케이션에서 디버거를 실행 되 고 있지 않으면 디버거를 열려면 있는 경우 디버거에서 코드를 보냅니다. 무시를 클릭하면 코드의 다음 명령이 계속됩니다.

참고

메시지 상자의 표시는 의 존재 DefaultTraceListener에 따라 달라집니다. 가 DefaultTraceListener 컬렉션에 Listeners 없으면 메시지 상자가 표시되지 않습니다. 를 DefaultTraceListener 호출하여 제거할 수 있습니다는 Clear 메서드를 Listeners 속성 (System.Diagnostics.Trace.Listeners.Clear()). .NET Framework 앱의 경우 앱의 <구성 파일에서 clear> 요소와 <remove> 요소를 사용할 수도 있습니다.

.NET Framework 앱의 경우 구성 파일에서 애플리케이션 이름 DefaultTraceListener 에 해당하는 의 동작을 변경할 수 있습니다. 이 파일에서 어설션 메시지 상자를 사용하거나 사용하지 않도록 설정하거나 속성을 설정할 DefaultTraceListener.LogFileName 수 있습니다. 구성 파일의 형식은 다음과 같이 지정해야 합니다.

<configuration>  
  <system.diagnostics>  
    <switches>  
      <add name="mySwitch" value="4"/>  
    </switches>  
    <trace autoflush="false" indentsize="4"/>  
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>  
  </system.diagnostics>  
</configuration>

추가 정보

적용 대상

Assert(Boolean, String)

Source:: Trace.cs

Source:: Trace.cs

Source:: Trace.cs

조건을 확인합니다. 조건이 false이면 지정된 메시지를 출력하고 호출 스택을 보여주는 메시지 상자를 표시합니다.

public:
 static void Assert(bool condition, System::String ^ message);

[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition, string? message);

[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition, string message);

[<System.Diagnostics.Conditional("TRACE")>]
static member Assert : bool * string -> unit

Public Shared Sub Assert (condition As Boolean, message As String)

매개 변수

condition: Boolean

계산할 조건부 식입니다. 조건이 true이면 지정된 메시지가 전송되지 않고 메시지 상자가 표시되지 않습니다.

message: String

Listeners 컬렉션으로 보낼 메시지입니다.

특성: ConditionalAttribute

예제

다음 예제에서는 매개 변수가 type 유효한지 확인합니다. 전달된 가 type 이 null면 는 Assert 메시지를 출력합니다.

public:
   static void MyMethod( Type^ type, Type^ baseType )
   {
     #if defined(TRACE)
     Trace::Assert( type != nullptr, "Type parameter is null" );
     #endif
      
      // Perform some processing.
   }

public static void MyMethod(Type type, Type baseType)
{
    Trace.Assert(type != null, "Type parameter is null");

    // Perform some processing.
}

Public Shared Sub MyMethod(type As Type, baseType As Type)
    Trace.Assert( Not (type Is Nothing), "Type parameter is null")

    ' Perform some processing.
End Sub

설명

일반적으로 메서드는 Assert(Boolean, String) 프로그램 개발 중에 논리 오류를 식별하는 데 사용됩니다. Assert(Boolean, String) 는 조건을 평가합니다. 결과가 false이면 지정된 진단 메시지를 컬렉션에 Listeners 보냅니다. 컬렉션에 를 TraceListener 추가하거나 컬렉션에서 Listeners 제거하여 이 동작을 사용자 지정할 수 있습니다.

참고

<configuration>  
  <system.diagnostics>  
    <switches>  
      <add name="mySwitch" value="4"/>  
    </switches>  
    <trace autoflush="false" indentsize="4"/>  
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>  
  </system.diagnostics>  
</configuration>

추가 정보

적용 대상

Assert(Boolean, String, String)

Source:: Trace.cs

Source:: Trace.cs

Source:: Trace.cs

조건을 확인합니다. 조건이 false이면 지정된 2개의 메시지를 출력하고 호출 스택을 보여주는 메시지 상자를 표시합니다.

public:
 static void Assert(bool condition, System::String ^ message, System::String ^ detailMessage);

[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition, string? message, string? detailMessage);

[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition, string message, string detailMessage);

[<System.Diagnostics.Conditional("TRACE")>]
static member Assert : bool * string * string -> unit

Public Shared Sub Assert (condition As Boolean, message As String, detailMessage As String)

매개 변수

condition: Boolean

계산할 조건부 식입니다. 조건이 true이면 지정된 메시지가 전송되지 않고 메시지 상자가 표시되지 않습니다.

message: String

Listeners 컬렉션으로 보낼 메시지입니다.

detailMessage: String

Listeners 컬렉션으로 보낼 자세한 메시지입니다.

특성: ConditionalAttribute

예제

다음 예제에서는 매개 변수가 type 유효한지 확인합니다. 전달된 가 type 이 null면 는 Assert 메시지를 출력합니다.

public:
   static void MyMethod( Type^ type, Type^ baseType )
   {
      #if defined(TRACE)
      Trace::Assert( type != nullptr, "Type parameter is null", "Can't get object for null type" );
      #endif
      
      // Perform some processing.
   }

public static void MyMethod(Type type, Type baseType)
{
    Trace.Assert(type != null, "Type parameter is null",
       "Can't get object for null type");

    // Perform some processing.
}

Public Shared Sub MyMethod(type As Type, baseType As Type)
    Trace.Assert( Not (type Is Nothing), "Type parameter is null", _
        "Can't get object for null type")

    ' Perform some processing.
End Sub

설명

일반적으로 메서드는 Assert(Boolean, String, String) 프로그램 개발 중에 논리 오류를 식별하는 데 사용됩니다. Assert 는 조건을 평가합니다. 결과가 false이면 지정된 진단 메시지와 자세한 메시지를 컬렉션에 Listeners 보냅니다. 컬렉션에 를 TraceListener 추가하거나 컬렉션에서 Listeners 제거하여 이 동작을 사용자 지정할 수 있습니다.

참고

<configuration>  
  <system.diagnostics>  
    <switches>  
      <add name="mySwitch" value="4"/>  
    </switches>  
    <trace autoflush="false" indentsize="4"/>  
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>  
  </system.diagnostics>  
</configuration>

추가 정보

적용 대상

다음을 통해 공유

Trace.Assert 메서드

정의

오버로드

Assert(Boolean)

매개 변수

예제

설명

추가 정보

적용 대상

Assert(Boolean, String)

매개 변수

예제

설명

추가 정보

적용 대상

Assert(Boolean, String, String)

매개 변수

예제

설명

추가 정보

적용 대상

추가 리소스