Debug.Assert 메서드

참조

정의

네임스페이스:: System.Diagnostics

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

어셈블리:: System.Runtime.dll

어셈블리:: System.dll

어셈블리:: netstandard.dll

중요

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

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

오버로드

Assert(Boolean)	조건을 확인합니다. 조건이 `false`이면 호출 스택을 보여주는 메시지 상자를 표시합니다.
Assert(Boolean, Debug+AssertInterpolatedStringHandler)	조건을 확인합니다. 조건이 `false`이면 지정된 메시지를 출력하고 호출 스택을 보여주는 메시지 상자를 표시합니다.
Assert(Boolean, String)	조건을 확인합니다. 조건이 `false`이면 지정된 메시지를 출력하고 호출 스택을 보여주는 메시지 상자를 표시합니다.
Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)	조건을 확인합니다. 조건이 `false`이면 지정된 메시지를 출력하고 호출 스택을 보여주는 메시지 상자를 표시합니다.
Assert(Boolean, String, String)	조건을 확인합니다. 조건이 `false`이면 지정된 2개의 메시지를 출력하고 호출 스택을 보여주는 메시지 상자를 표시합니다.
Assert(Boolean, String, String, Object[])	조건을 확인합니다. 조건이 `false`이면 두 개의 메시지(단순 및 서식 있는 메시지)를 출력하고 호출 스택을 보여 주는 메시지 상자를 표시합니다.

Assert(Boolean)

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

public:
 static void Assert(bool condition);

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

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

Public Shared Sub Assert (condition As Boolean)

매개 변수

condition: Boolean

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

특성: ConditionalAttribute

예제

다음 예제에서는 배열에 대한 인덱스를 만들고, 인덱스의 값을 설정하는 몇 가지 작업을 수행한 다음, 인덱스 값이 유효한지 확인하기 위해 호출 Assert 합니다. 유효 Assert 하지 않으면 호출 스택을 출력합니다.

// Create a local value.
int index;

// Perform some action that sets the local value.
index = -40;

// Test that the local value is valid. 
#if defined(DEBUG)
Debug::Assert( index > -1 );
#endif

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

// Perform some action that sets the index.
index = -40;

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

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

' Perform some action that sets the index.
index = -40

' Test that the index value is valid. 
Debug.Assert((index > - 1))

설명

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

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

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

참고

Windows 8.x 앱은 모달 대화 상자를 지원하지 않으므로 사용자 인터페이스 모드 및 비 사용자 인터페이스 모드에서 동일하게 동작합니다. 메시지는 디버깅 모드에서 활성 추적 수신기에 기록되거나 릴리스 모드로 기록되지 않습니다.

참고

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

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

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

추가 정보

적용 대상

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

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

public:
 static void Assert(bool condition, System::Diagnostics::Debug::AssertInterpolatedStringHandler % message);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler message);

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

Public Shared Sub Assert (condition As Boolean, ByRef message As Debug.AssertInterpolatedStringHandler)

매개 변수

condition: Boolean

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

message: Debug.AssertInterpolatedStringHandler

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

특성: ConditionalAttribute

설명

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

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

참고

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

추가 정보

적용 대상

Assert(Boolean, String)

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

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

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

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

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

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

매개 변수

condition: Boolean

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

message: String

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

특성: ConditionalAttribute

예제

다음 예제에서는 매개 변수가 type 유효한지 여부를 확인합니다. 이 nullAssert 경우 type 메시지를 출력합니다.

void MyMethod( Object^ obj, Type^ type )
{
   #if defined(DEBUG)
   Debug::Assert( type != nullptr, "Type paramater is null" );
   #endif
}

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

    // Perform some processing.
}

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

설명

참고

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

추가 정보

적용 대상

Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)

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

public:
 static void Assert(bool condition, System::Diagnostics::Debug::AssertInterpolatedStringHandler % message, System::Diagnostics::Debug::AssertInterpolatedStringHandler % detailMessage);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler message, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler detailMessage);

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

Public Shared Sub Assert (condition As Boolean, ByRef message As Debug.AssertInterpolatedStringHandler, ByRef detailMessage As Debug.AssertInterpolatedStringHandler)

매개 변수

condition: Boolean

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

message: Debug.AssertInterpolatedStringHandler

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

detailMessage: Debug.AssertInterpolatedStringHandler

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

특성: ConditionalAttribute

설명

참고

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

추가 정보

적용 대상

Assert(Boolean, String, String)

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

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

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

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

[<System.Diagnostics.Conditional("DEBUG")>]
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 유효한지 여부를 확인합니다. 이 nullAssert 경우 type 두 개의 메시지를 출력합니다.

void MyMethod( Object^ obj, Type^ type )
{
   #if defined(DEBUG)
   Debug::Assert( type != nullptr, "Type paramater is null", "Can't get object for null type" );
   #endif
}

public static void MyMethod(Type type, Type baseType)
{
    Debug.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)
    Debug.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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

추가 정보

적용 대상

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

조건을 확인합니다. 조건이 false이면 두 개의 메시지(단순 및 서식 있는 메시지)를 출력하고 호출 스택을 보여 주는 메시지 상자를 표시합니다.

public:
 static void Assert(bool condition, System::String ^ message, System::String ^ detailMessageFormat, ... cli::array <System::Object ^> ^ args);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string message, string detailMessageFormat, params object[] args);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, string? message, string detailMessageFormat, params object?[] args);

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

Public Shared Sub Assert (condition As Boolean, message As String, detailMessageFormat As String, ParamArray args As Object())

매개 변수

condition: Boolean

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

message: String

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

detailMessageFormat: String

Listeners 컬렉션에 보낼 복합 서식 문자열입니다. 이 메시지에는 args 배열의 개체에 해당하는 0개 이상의 서식 항목과 혼합된 텍스트가 포함됩니다.

args: Object[]

형식을 지정할 개체를 0개 이상 포함하는 개체 배열입니다.

특성: ConditionalAttribute

설명

이 메서드는 .NET 복합 서식 지정 기능을 사용하여 개체의 값을 텍스트 표현으로 변환하고 해당 표현을 문자열에 포함합니다. 결과 문자열이 컬렉션으로 Listeners 전송됩니다.

일반적으로 Assert(Boolean, String, String, Object[]) 이 메서드는 프로그램 개발 중에 논리 오류를 식별하는 데 사용됩니다. Assert 는 조건을 평가합니다. 결과가 있으면 false메서드가 String.Format(String, Object[]) 호출되고 detailMessageFormat 문자열과 args 배열이 매개 변수로 전달됩니다. Assert(Boolean, String, String, Object[]) 지정된 문자 메시지와 서식이 지정된 문자 메시지를 컬렉션에 Listeners 보냅니다. 컬렉션에 추가 TraceListener 하거나 컬렉션에서 Listeners 하나를 제거하여 이 동작을 사용자 지정할 수 있습니다.

참고

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

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

적용 대상

Debug.Assert 메서드

정의

오버로드

Assert(Boolean)

매개 변수

예제

설명

추가 정보

적용 대상

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

매개 변수

설명

추가 정보

적용 대상

Assert(Boolean, String)

매개 변수

예제

설명

추가 정보

적용 대상

Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)

매개 변수

설명

추가 정보

적용 대상

Assert(Boolean, String, String)

매개 변수

예제

설명

추가 정보

적용 대상

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

매개 변수

설명

적용 대상

추가 리소스