System.Type.GetProperty 메서드

  • 아티클

이 문서에서는 이 API에 대한 참조 설명서에 대한 추가 설명서를 제공합니다.

GetProperty(String) 메서드

검색 name 은 대/소문자를 구분합니다. 검색에는 공용 정적 및 공용 인스턴스 속성이 포함됩니다.

속성은 공용인 접근자가 하나 이상 있는 경우 공용으로 간주되어 리플렉션됩니다. 그렇지 않으면 속성이 프라이빗으로 간주되며, 속성을 얻으려면 (Visual Basic에서는 값을 사용하여 결합)을 사용해야 BindingFlags.NonPublic | | BindingFlags.InstanceBindingFlags.Static 합니다.Or

현재 Type 가 생성된 제네릭 형식을 나타내는 경우 이 메서드는 적절한 형식 인수로 대체된 형식 매개 변수를 반환 PropertyInfo 합니다.

현재 Type 제네릭 형식 또는 제네릭 메서드 정의에서 형식 매개 변수를 나타내는 경우 이 메서드는 클래스 제약 조건의 속성을 검색합니다.

발생하는 상황에는 AmbiguousMatchException 다음이 포함됩니다.

  • 형식에는 이름이 같지만 매개 변수 수가 다른 두 개의 인덱싱된 속성이 포함됩니다. 모호성을 해결하려면 매개 변수 형식을 지정하는 메서드의 GetProperty 오버로드를 사용합니다.
  • 파생 형식은 Visual Basic에서 한정Shadows자를 사용하여 new 동일한 이름의 상속된 속성을 숨기는 속성을 선언합니다. 모호성을 해결하려면 메서드 오버로드를 GetProperty(String, BindingFlags) 사용하고 플래그를 BindingFlags.DeclaredOnly 추가하여 상속되지 않은 멤버로 검색을 제한합니다.

GetProperty(String, BindingFlags) 메서드

속성은 공용인 접근자가 하나 이상 있는 경우 공용으로 간주되어 리플렉션됩니다. 그렇지 않으면 속성이 프라이빗으로 간주되며, 속성을 얻으려면 (Visual Basic에서는 값을 사용하여 결합)을 사용해야 BindingFlags.NonPublic | | BindingFlags.InstanceBindingFlags.Static 합니다.Or

다음 BindingFlags 필터 플래그를 사용하여 검색에 포함할 속성을 정의할 수 있습니다.

  • 반환을 얻으려면 지정하거나 BindingFlags.Static 지정 BindingFlags.Instance 해야 합니다.
  • 검색에 공용 속성을 포함하도록 지정 BindingFlags.Public 합니다.
  • 검색에 public이 아닌 속성(즉, 프라이빗, 내부 및 보호된 속성)을 포함하도록 지정 BindingFlags.NonPublic 합니다.
  • 계층 private 을 포함 public 및 protected 정적 멤버로 지정 BindingFlags.FlattenHierarchy 합니다. 상속된 클래스의 정적 멤버는 포함되지 않습니다.

다음 BindingFlags 한정자 플래그를 사용하여 검색 작동 방식을 변경할 수 있습니다.

  • BindingFlags.IgnoreCase 의 대/소문 name자를 무시합니다.
  • BindingFlags.DeclaredOnly 단순히 상속된 속성이 아니라 선언 Type된 속성만 검색합니다.

자세한 내용은 System.Reflection.BindingFlags 을 참조하세요.

현재 Type 가 생성된 제네릭 형식을 나타내는 경우 이 메서드는 적절한 형식 인수로 대체된 형식 매개 변수를 반환 PropertyInfo 합니다.

현재 Type 제네릭 형식 또는 제네릭 메서드 정의에서 형식 매개 변수를 나타내는 경우 이 메서드는 클래스 제약 조건의 속성을 검색합니다.

발생하는 상황에는 AmbiguousMatchException 다음이 포함됩니다.

  • 형식에는 이름이 같지만 매개 변수 수가 다른 두 개의 인덱싱된 속성이 포함됩니다. 모호성을 해결하려면 매개 변수 형식을 지정하는 메서드의 GetProperty 오버로드를 사용합니다.
  • 파생 형식은 한정자(ShadowsVisual Basic)를 사용하여 new 동일한 이름의 상속된 속성을 숨기는 속성을 선언합니다. 모호성을 해결하려면 상속되지 않은 멤버로 검색을 제한하도록 포함합니다 BindingFlags.DeclaredOnly .

GetProperty(System.String,System.Reflection.BindingFlags,System.Reflection.Binder,System.Type,System.Type[],System.Reflection.ParameterModifier[])

속성은 공용인 접근자가 하나 이상 있는 경우 공용으로 간주되어 리플렉션됩니다. 그렇지 않으면 속성이 프라이빗으로 간주되며, 속성을 얻으려면 (Visual Basic에서는 값을 사용하여 결합)을 사용해야 BindingFlags.NonPublic | | BindingFlags.InstanceBindingFlags.Static 합니다.Or

기본 바인더는 처리 ParameterModifier 하지 않지만( modifiers 매개 변수) 추상 System.Reflection.Binder 클래스를 사용하여 처리하는 modifiers사용자 지정 바인더를 작성할 수 있습니다. ParameterModifier 는 COM interop을 통해 호출할 때만 사용되며 참조로 전달되는 매개 변수만 처리됩니다.

다음 표에서는 형식을 반영할 때 메서드에서 반환되는 기본 클래스의 Get 멤버를 보여 줍니다.

멤버 형식 정적 비정적
생성자 아니요 예
필드 아니요 예. 필드는 항상 이름별 및 서명으로 숨깁니다.
이벤트 해당 없음 일반적인 형식 시스템 규칙은 상속이 속성을 구현하는 메서드의 상속과 동일하다는 것입니다. 리플렉션은 속성을 이름별 숨기기 및 서명으로 처리합니다.2
메서드 아니요 예. 메서드(가상 및 가상이 아닌 메서드)는 이름별 숨기기 또는 이름별 숨기기 및 서명일 수 있습니다.
중첩 형식 아니요 아니요
속성 해당 없음 일반적인 형식 시스템 규칙은 상속이 속성을 구현하는 메서드의 상속과 동일하다는 것입니다. 리플렉션은 속성을 이름별 숨기기 및 서명으로 처리합니다.2

참고:

  1. 이름별 숨기기 및 서명은 사용자 지정 한정자, 반환 형식, 매개 변수 형식, sentinels 및 관리되지 않는 호출 규칙을 포함하여 서명의 모든 부분을 고려합니다. 이진 비교입니다.
  2. 리플렉션의 경우 속성과 이벤트는 이름 및 서명별로 숨겨집니다. 기본 클래스에 get 및 set 접근자가 모두 있는 속성이 있지만 파생 클래스에 get 접근자만 있는 경우 파생 클래스 속성은 기본 클래스 속성을 숨기며 기본 클래스의 setter에 액세스할 수 없습니다.
  3. 사용자 지정 특성은 공용 형식 시스템의 일부가 아닙니다.

다음 BindingFlags 필터 플래그를 사용하여 검색에 포함할 속성을 정의할 수 있습니다.

  • 반환을 얻으려면 지정하거나 BindingFlags.Static 지정 BindingFlags.Instance 해야 합니다.
  • 검색에 공용 속성을 포함하도록 지정 BindingFlags.Public 합니다.
  • 검색에 public이 아닌 속성(즉, 프라이빗, 내부 및 보호된 속성)을 포함하도록 지정 BindingFlags.NonPublic 합니다.
  • 계층 private 을 포함 public 및 protected 정적 멤버로 지정 BindingFlags.FlattenHierarchy 합니다. 상속된 클래스의 정적 멤버는 포함되지 않습니다.

다음 BindingFlags 한정자 플래그를 사용하여 검색 작동 방식을 변경할 수 있습니다.

  • BindingFlags.IgnoreCase 의 대/소문 name자를 무시합니다.
  • BindingFlags.DeclaredOnly 단순히 상속된 속성이 아니라 선언 Type된 속성만 검색합니다.

자세한 내용은 System.Reflection.BindingFlags 을 참조하세요.

현재 Type 가 생성된 제네릭 형식을 나타내는 경우 이 메서드는 적절한 형식 인수로 대체된 형식 매개 변수를 반환 PropertyInfo 합니다.

현재 Type 제네릭 형식 또는 제네릭 메서드 정의에서 형식 매개 변수를 나타내는 경우 이 메서드는 클래스 제약 조건의 속성을 검색합니다.

인덱서 및 기본 속성

Visual Basic, C# 및 C++에는 인덱싱된 속성에 액세스하기 위한 구문이 간소화되었으며 인덱싱된 속성 하나가 해당 형식의 기본값이 되도록 허용합니다. 예를 들어 변수 myList 가 참조 ArrayList하는 경우 구문 myList[3] (myList(3) Visual Basic)은 인덱스가 3인 요소를 검색합니다. 속성을 오버로드할 수 있습니다.

C#에서 이 기능을 인덱서라고 하며 이름으로 참조할 수 없습니다. 기본적으로 C# 인덱서는 메타데이터에 이름이 인 Item덱싱된 속성으로 나타납니다. 그러나 클래스 라이브러리 개발자는 특성을 사용하여 IndexerNameAttribute 메타데이터에서 인덱서의 이름을 변경할 수 있습니다. 예를 들어 클래스에는 String 이름이 .인 Chars[]덱서가 있습니다. C# 이외의 언어를 사용하여 만든 인덱싱된 속성에는 다른 Item이름도 있을 수 있습니다.

형식에 기본 속성이 있는지 확인하려면 메서드를 GetCustomAttributes(Type, Boolean) 사용하여 특성을 테스트 DefaultMemberAttribute 합니다. 형식 DefaultMemberAttribute이 있는 경우 속성은 MemberName 기본 속성의 이름을 반환합니다.