Type.GetNestedType 메서드
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
현재 Type에 중첩된 특정 형식을 가져옵니다.
GetNestedType(String) |
지정된 이름의 public 중첩 형식을 검색합니다. |
GetNestedType(String, BindingFlags) |
파생 클래스에서 재정의되면, 지정된 중첩 형식을 지정된 바인딩 제약 조건으로 검색합니다. |
- Source:
- Type.cs
- Source:
- Type.cs
- Source:
- Type.cs
지정된 이름의 public 중첩 형식을 검색합니다.
public:
Type ^ GetNestedType(System::String ^ name);
public:
virtual Type ^ GetNestedType(System::String ^ name);
public Type? GetNestedType (string name);
public Type GetNestedType (string name);
member this.GetNestedType : string -> Type
abstract member GetNestedType : string -> Type
override this.GetNestedType : string -> Type
Public Function GetNestedType (name As String) As Type
매개 변수
- name
- String
가져올 중첩 형식의 이름이 포함된 문자열입니다.
반환
지정된 이름의 public 중첩 형식을 나타내는 개체이며(있는 경우), 이러한 개체가 없으면 null
을 반환합니다.
구현
예외
name
이(가) null
인 경우
설명
검색 name
은 대/소문자를 구분합니다.
에 중첩 클래스 name
의 간단한 이름을 사용합니다. 외부 클래스의 이름으로 한정하지 마세요. 제네릭 중첩 클래스의 경우 mangled name을 사용합니다. 즉, 그레이브 악센트와 제네릭 인수 수를 추가합니다. 예를 들어 문자열 "Inner'1"을 사용하여 제네릭 중첩 클래스 Inner<T>
(Inner(Of T)
Visual Basic의 경우)를 가져옵니다. 형식 매개 변수에 대한 언어별 구문을 포함하지 마세요.
다음 표에서는 형식을 반영할 때 메서드에서 Get
반환되는 기본 클래스의 멤버를 보여 줍니다.
멤버 형식 | 정적 | 비정적 |
---|---|---|
생성자 | 아니요 | 예 |
필드 | 아니요 | 예. 필드는 항상 이름별 및 서명으로 숨겨집니다. |
이벤트 | 적용할 수 없음 | 일반적인 형식 시스템 규칙은 상속이 속성을 구현하는 메서드의 상속과 동일하다는 것입니다. 리플렉션은 속성을 이름별 숨기기 및 서명으로 처리합니다. 아래 참고 2를 참조하세요. |
메서드 | 아니요 | 예. 메서드(가상 및 가상이 아닌 메서드)는 이름별 숨기기 또는 이름별 숨기기 및 서명일 수 있습니다. |
중첩 형식 | 아니요 | 아니요 |
속성 | 적용할 수 없음 | 일반적인 형식 시스템 규칙은 상속이 속성을 구현하는 메서드의 상속과 동일하다는 것입니다. 리플렉션은 속성을 이름별 숨기기 및 서명으로 처리합니다. 아래 참고 2를 참조하세요. |
이름별 숨기기 및 서명은 사용자 지정 한정자, 반환 형식, 매개 변수 형식, sentinels 및 관리되지 않는 호출 규칙을 포함하여 서명의 모든 부분을 고려합니다. 이진 비교입니다.
리플렉션의 경우 속성 및 이벤트는 이름별 숨기기 및 서명입니다. 기본 클래스에 get 및 set 접근자가 모두 있는 속성이 있지만 파생 클래스에 get 접근자만 있는 경우 파생 클래스 속성은 기본 클래스 속성을 숨기며 기본 클래스의 setter에 액세스할 수 없습니다.
사용자 지정 특성은 공용 형식 시스템의 일부가 아닙니다.
현재 Type 가 제네릭 형식 또는 제네릭 메서드의 정의에서 형식 매개 변수를 나타내는 경우 이 메서드는 클래스 제약 조건의 중첩된 형식을 검색합니다.
중첩된 형식이 제네릭인 경우 이 메서드는 제네릭 형식 정의를 반환합니다. 바깥쪽 제네릭 형식이 닫힌 생성 형식인 경우에도 마찬가지입니다.
참고
현재 Type 가 C#, Visual Basic 또는 C++에 정의된 제네릭 형식을 나타내는 경우 자체의 제네릭 매개 변수가 없더라도 중첩된 형식은 모두 제네릭 형식입니다. 동적 어셈블리에 정의되거나 Ilasm.exe(IL 어셈블러)로 컴파일된 중첩 형식의 경우 반드시 해당되는 것은 아닙니다.
중첩된 제네릭 형식 및 제네릭 형식 정의에서 중첩된 제네릭 형식을 생성하는 방법에 대한 자세한 내용은 를 참조 MakeGenericType하세요.
추가 정보
적용 대상
.NET 9 및 기타 버전
제품 | 버전 |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- Source:
- Type.cs
- Source:
- Type.cs
- Source:
- Type.cs
파생 클래스에서 재정의되면, 지정된 중첩 형식을 지정된 바인딩 제약 조건으로 검색합니다.
public:
abstract Type ^ GetNestedType(System::String ^ name, System::Reflection::BindingFlags bindingAttr);
public abstract Type? GetNestedType (string name, System.Reflection.BindingFlags bindingAttr);
public abstract Type GetNestedType (string name, System.Reflection.BindingFlags bindingAttr);
abstract member GetNestedType : string * System.Reflection.BindingFlags -> Type
Public MustOverride Function GetNestedType (name As String, bindingAttr As BindingFlags) As Type
매개 변수
- name
- String
가져올 중첩 형식의 이름이 포함된 문자열입니다.
반환
지정된 요구 사항과 일치하는 중첩 형식을 나타내는 개체이며(있는 경우), 이러한 개체가 없으면 null
을 반환합니다.
구현
예외
name
이(가) null
인 경우
설명
에 중첩 클래스 name
의 간단한 이름을 사용합니다. 외부 클래스의 이름으로 한정하지 마세요. 제네릭 중첩 클래스의 경우 mangled name을 사용합니다. 즉, 그레이브 악센트와 제네릭 매개 변수 수를 추가합니다. 예를 들어 문자열 "Inner'1"을 사용하여 제네릭 중첩 클래스 Inner<T>
(Inner(Of T)
Visual Basic의 경우)를 가져옵니다. 형식 매개 변수에 대한 언어별 구문을 포함하지 마세요.
다음 BindingFlags 필터 플래그를 사용하여 검색에 포함할 중첩 형식을 정의할 수 있습니다.
반환을 얻으려면 또는 BindingFlags.NonPublic 를 BindingFlags.Public 지정해야 합니다.
검색에 공용 중첩 형식을 포함하도록 지정 BindingFlags.Public 합니다.
검색에 공용이 아닌 중첩 형식(즉, 프라이빗, 내부 및 보호된 중첩 형식)을 포함하도록 지정 BindingFlags.NonPublic 합니다.
이 메서드는 현재 형식의 중첩된 형식만 반환합니다. 현재 형식의 기본 클래스를 검색하지 않습니다. 기본 클래스에 중첩된 형식을 찾으려면 각 수준에서 를 호출 GetNestedType 하여 상속 계층 구조를 수행해야 합니다.
BindingFlags.Instance 및 BindingFlags.Static은 무시됩니다.
플래그 또는 플래그만 사용하여 이 메서드를 BindingFlags.PublicBindingFlags.NonPublic 호출하면 지정된 중첩 형식이 반환되며 다른 플래그가 필요하지 않습니다.
자세한 내용은 System.Reflection.BindingFlags를 참조하세요.
현재 Type 가 제네릭 형식 또는 제네릭 메서드의 정의에서 형식 매개 변수를 나타내는 경우 이 메서드는 클래스 제약 조건의 중첩된 형식을 검색합니다.
중첩된 형식이 제네릭인 경우 이 메서드는 제네릭 형식 정의를 반환합니다. 바깥쪽 제네릭 형식이 닫힌 생성 형식인 경우에도 마찬가지입니다.
참고
현재 Type 가 C#, Visual Basic 또는 C++에 정의된 제네릭 형식을 나타내는 경우 자체의 제네릭 매개 변수가 없더라도 중첩된 형식은 모두 제네릭 형식입니다. 동적 어셈블리에 정의되거나 Ilasm.exe(IL 어셈블러)로 컴파일된 중첩 형식의 경우 반드시 해당되는 것은 아닙니다.
중첩된 제네릭 형식 및 제네릭 형식 정의에서 중첩된 제네릭 형식을 생성하는 방법에 대한 자세한 내용은 를 참조 MakeGenericType하세요.
추가 정보
적용 대상
.NET 9 및 기타 버전
제품 | 버전 |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
.NET 피드백
.NET은(는) 오픈 소스 프로젝트입니다. 다음 링크를 선택하여 피드백을 제공해 주세요.