정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

ConditionalAttribute 클래스

2013-12-13

지정한 조건부 컴파일 기호가 정의되어 있지 않으면 메서드 호출이나 특성을 무시하도록 컴파일러에 알립니다.

System.Object
  System.Attribute
    System.Diagnostics.ConditionalAttribute

Namespace:  System.Diagnostics
어셈블리:  mscorlib(mscorlib.dll)

[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Method, AllowMultiple = true)]
public sealed class ConditionalAttribute : Attribute

ConditionalAttribute 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Public 메서드ConditionalAttributeConditionalAttribute 클래스의 새 인스턴스를 초기화합니다.
맨 위

  이름설명
Public 속성ConditionStringConditionalAttribute 특성과 관련된 조건부 컴파일 기호를 가져옵니다.
맨 위

  이름설명
Public 메서드Equals인프라입니다. 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (Attribute에서 상속됨)
Protected 메서드Finalize가비지 수집기에서 Object를 회수하기 전에 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드GetHashCode해당 인스턴스에 대한 해시 코드를 반환합니다. (Attribute에서 상속됨)
Public 메서드GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Public 메서드Match파생 클래스에서 재정의된 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (Attribute에서 상속됨)
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드ToString현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
맨 위

ConditionalAttribute 특성은 메서드와 클래스에 적용할 수 있습니다. 그러나 클래스에 사용하는 경우 Attribute에서 파생된 형식이어야 합니다. ConditionalAttribute를 다른 형식에 적용할 경우 무시되거나 컴파일러 경고 또는 오류 메시지가 생성됩니다.

ConditionalAttribute를 메서드에 적용하는 경우 ConditionalAttribute와 관련된 조건부 컴파일 기호가 정의되어 있지 않으면 메서드 호출을 MSIL(Microsoft Intermediate Language)로 컴파일하지 않도록 컴파일러에 지시합니다. ConditionalAttribute를 특성에 적용하는 경우 조건부 컴파일 기호가 정의되어 있지 않으면 특성을 메타데이터로 내보내지 않아야 함을 나타냅니다. 메서드나 특성에 전달된 모든 인수의 형식은 컴파일러에서 확인합니다.

다음과 같은 방법을 통해 조건부 컴파일 기호를 정의할 수 있습니다.

  • 컴파일러 명령줄 옵션(예: /define:DEBUG)

  • 운영 체제 셸의 환경 변수(예: set DEBUG=1)

  • 소스 코드의 pragma(예: 컴파일 변수를 정의하는 #define DEBUG 및 컴파일 변수 정의를 해제하는 #undef DEBUG)

CLS(공용 언어 사양)를 따르는 컴파일러는 ConditionalAttribute를 무시할 수 있습니다. C#, J# 및 Visual Basic 컴파일러에서는 ConditionalAttribute를 지원하지만 C++ 및 JScript 컴파일러에서는 지원하지 않습니다.

ConditionalAttributeDebug 클래스에 정의되어 있는 메서드에 적용됩니다.

Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 모든 인스턴스 멤버는 스레드로부터 안전하지 않을 수 있습니다.

표시: