Type.GetNestedType 메서드

정의

현재 Type에 중첩된 특정 형식을 가져옵니다.Gets a specific type nested within the current Type.

오버로드

GetNestedType(String, BindingFlags)

파생 클래스에서 재정의되면, 지정된 중첩 형식을 지정된 바인딩 제약 조건으로 검색합니다.When overridden in a derived class, searches for the specified nested type, using the specified binding constraints.

GetNestedType(String)

지정된 이름의 public 중첩 형식을 검색합니다.Searches for the public nested type with the specified name.

GetNestedType(String, BindingFlags)

파생 클래스에서 재정의되면, 지정된 중첩 형식을 지정된 바인딩 제약 조건으로 검색합니다.When overridden in a derived class, searches for the specified nested type, using the specified binding constraints.

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

가져올 중첩 형식의 이름이 포함된 문자열입니다.The string containing the name of the nested type to get.

bindingAttr
BindingFlags

검색 방법을 지정하는 열거형 값의 비트 조합입니다.A bitwise combination of the enumeration values that specify how the search is conducted.

또는-or- null을 반환하는 Default입니다.Default to return null.

반환

Type

지정된 요구 사항과 일치하는 중첩 형식을 나타내는 개체이며(있는 경우), 이러한 개체가 없으면 null을 반환합니다.An object representing the nested type that matches the specified requirements, if found; otherwise, null.

구현

예외

name이(가) null인 경우name is null.

설명

에 대해 중첩 된 클래스의 단순한 이름을 사용 name 합니다.Use the simple name of the nested class for name. 외부 클래스의 이름으로 한정 하지 마십시오.Do not qualify it with the name of the outer class. 제네릭 중첩 된 클래스의 경우 올바른 이름을 사용 합니다. 즉, 억음 악센트와 제네릭 매개 변수 수를 추가 합니다.For a generic nested class, use the mangled name - that is, append a grave accent and the number of generic parameters. 예를 들어 "Inner 1" 문자열을 사용 ` 하 여 제네릭 중첩 된 클래스 Inner<T> ( Inner(Of T) Visual Basic)를 가져옵니다.For example, use the string "Inner`1" to get the generic nested class Inner<T> (Inner(Of T) in Visual Basic). 형식 매개 변수에 대 한 언어별 구문을 포함 하지 않습니다.Do not include language-specific syntax for type parameters.

다음 BindingFlags 필터 플래그는 검색에 포함할 중첩 형식을 정의 하는 데 사용할 수 있습니다.The following BindingFlags filter flags can be used to define which nested types to include in the search:

이 메서드는 현재 형식의 중첩 형식만 반환 합니다.This method returns only the nested types of the current type. 현재 형식의 기본 클래스는 검색 하지 않습니다.It does not search the base classes of the current type. 기본 클래스에 중첩 된 형식을 찾으려면 각 수준에서를 호출 하 여 상속 계층 구조를 탐색 해야 합니다 GetNestedType .To find types that are nested in base classes, you must walk the inheritance hierarchy, calling GetNestedType at each level.

BindingFlags.InstanceBindingFlags.Static 는 무시 됩니다.BindingFlags.Instance and BindingFlags.Static are ignored.

플래그만 사용 하거나 플래그만 사용 하 여이 메서드를 호출 BindingFlags.Public BindingFlags.NonPublic 하면 지정 된 중첩 형식이 반환 되 고 다른 플래그는 필요 하지 않습니다.Calling this method with only the BindingFlags.Public flag or only the BindingFlags.NonPublic flag will return the specified nested types and does not require any other flags.

자세한 내용은 System.Reflection.BindingFlags를 참조하세요.See System.Reflection.BindingFlags for more information.

현재 Type 이 제네릭 형식 또는 제네릭 메서드 정의의 형식 매개 변수를 나타내는 경우이 메서드는 클래스 제약 조건의 중첩 형식을 검색 합니다.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the nested types of the class constraint.

중첩 형식이 제네릭이 면이 메서드는 제네릭 형식 정의를 반환 합니다.If a nested type is generic, this method returns its generic type definition. 바깥쪽 제네릭 형식이 폐쇄형 생성 형식인 경우에도 마찬가지입니다.This is true even if the enclosing generic type is a closed constructed type.

참고

현재이 Type c #, Visual Basic 또는 c + +로 정의 된 제네릭 형식을 나타내는 경우 자체의 제네릭 매개 변수가 없는 경우에도 해당 중첩 형식은 모두 제네릭입니다.If the current Type represents a generic type defined in C#, Visual Basic, or C++, its nested types are all generic even if they have no generic parameters of their own. 동적 어셈블리에 정의 된 중첩 형식이 나 Ilasm.exe (IL 어셈블러)로 컴파일된 경우에는 이러한 방식이 반드시 적용 되는 것은 아닙니다.This is not necessarily true of nested types defined in dynamic assemblies or compiled with the Ilasm.exe (IL Assembler).

중첩 된 제네릭 형식에 대 한 자세한 내용과 제네릭 형식 정의에서 중첩 된 제네릭 형식을 생성 하는 방법에 대 한 자세한 내용은을 참조 하십시오 MakeGenericType .For information on nested generic types, and on constructing nested generic types from their generic type definitions, see MakeGenericType.

추가 정보

적용 대상

GetNestedType(String)

지정된 이름의 public 중첩 형식을 검색합니다.Searches for the public nested type with the specified name.

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

가져올 중첩 형식의 이름이 포함된 문자열입니다.The string containing the name of the nested type to get.

반환

Type

지정된 이름의 public 중첩 형식을 나타내는 개체이며(있는 경우), 이러한 개체가 없으면 null을 반환합니다.An object representing the public nested type with the specified name, if found; otherwise, null.

구현

예외

name이(가) null인 경우name is null.

설명

검색은 대 name /소문자를 구분 합니다.The search for name is case-sensitive.

에 대해 중첩 된 클래스의 단순한 이름을 사용 name 합니다.Use the simple name of the nested class for name. 외부 클래스의 이름으로 한정 하지 마십시오.Do not qualify it with the name of the outer class. 제네릭 중첩 된 클래스의 경우 올바른 이름을 사용 합니다. 즉, 억음 악센트와 제네릭 인수 수를 추가 합니다.For a generic nested class, use the mangled name - that is, append a grave accent and the number of generic arguments. 예를 들어 "Inner 1" 문자열을 사용 ` 하 여 제네릭 중첩 된 클래스 Inner<T> ( Inner(Of T) Visual Basic)를 가져옵니다.For example, use the string "Inner`1" to get the generic nested class Inner<T> (Inner(Of T) in Visual Basic). 형식 매개 변수에 대 한 언어별 구문을 포함 하지 않습니다.Do not include language-specific syntax for type parameters.

다음 표에서는 Get 형식에 대해 리플렉션할 때 메서드에서 반환 되는 기본 클래스의 멤버를 보여 줍니다.The following table shows what members of a base class are returned by the Get methods when reflecting on a type.

멤버 형식Member Type 정적Static 비정적Non-Static
생성자Constructor 아니요No 아니요No
필드Field 아니요No 예.Yes. 필드는 항상 이름 및 시그니처로 숨겨집니다.A field is always hide-by-name-and-signature.
이벤트Event 해당 없음Not applicable 공용 형식 시스템 규칙은 상속이 속성을 구현 하는 메서드와 동일 하다는 것입니다.The common type system rule is that the inheritance is the same as that of the methods that implement the property. 리플렉션에서는 속성을 이름으로 숨기기-서명으로 처리 합니다.Reflection treats properties as hide-by-name-and-signature. 아래의 참고 2를 참조 하세요.See note 2 below.
메서드Method 아니요No 예.Yes. 메서드 (가상 및 비가상)는 이름을 기준으로 숨기 거 나 이름에 따라 숨길 수 있습니다.A method (both virtual and non-virtual) can be hide-by-name or hide-by-name-and-signature.
중첩 형식Nested Type 아니요No 아니요No
속성Property 해당 없음Not applicable 공용 형식 시스템 규칙은 상속이 속성을 구현 하는 메서드와 동일 하다는 것입니다.The common type system rule is that the inheritance is the same as that of the methods that implement the property. 리플렉션에서는 속성을 이름으로 숨기기-서명으로 처리 합니다.Reflection treats properties as hide-by-name-and-signature. 아래의 참고 2를 참조 하세요.See note 2 below.
  1. 이름 및 시그니처는 사용자 지정 한정자, 반환 형식, 매개 변수 형식, 센티널 및 관리 되지 않는 호출 규칙을 포함 하 여 시그니처의 모든 부분을 고려 합니다.Hide-by-name-and-signature considers all of the parts of the signature, including custom modifiers, return types, parameter types, sentinels, and unmanaged calling conventions. 이는 이진 비교입니다.This is a binary comparison.

  2. 리플렉션의 경우 속성과 이벤트는 이름 및 시그니처로 숨겨집니다.For reflection, properties and events are hide-by-name-and-signature. 기본 클래스에 get 및 set 접근자가 모두 포함 된 속성이 있지만 파생 클래스에 get 접근자만 있는 경우 파생 클래스 속성은 기본 클래스 속성을 숨기고 기본 클래스의 setter에 액세스할 수 없게 됩니다.If you have a property with both a get and a set accessor in the base class, but the derived class has only a get accessor, the derived class property hides the base class property, and you will not be able to access the setter on the base class.

  3. 사용자 지정 특성은 공용 형식 시스템의 일부가 아닙니다.Custom attributes are not part of the common type system.

현재 Type 이 제네릭 형식 또는 제네릭 메서드 정의의 형식 매개 변수를 나타내는 경우이 메서드는 클래스 제약 조건의 중첩 형식을 검색 합니다.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the nested types of the class constraint.

중첩 형식이 제네릭이 면이 메서드는 제네릭 형식 정의를 반환 합니다.If a nested type is generic, this method returns its generic type definition. 바깥쪽 제네릭 형식이 폐쇄형 생성 형식인 경우에도 마찬가지입니다.This is true even if the enclosing generic type is a closed constructed type.

참고

현재이 Type c #, Visual Basic 또는 c + +로 정의 된 제네릭 형식을 나타내는 경우 자체의 제네릭 매개 변수가 없는 경우에도 해당 중첩 형식은 모두 제네릭입니다.If the current Type represents a generic type defined in C#, Visual Basic, or C++, its nested types are all generic even if they have no generic parameters of their own. 동적 어셈블리에 정의 된 중첩 형식이 나 Ilasm.exe (IL 어셈블러)로 컴파일된 경우에는 이러한 방식이 반드시 적용 되는 것은 아닙니다.This is not necessarily true of nested types defined in dynamic assemblies or compiled with the Ilasm.exe (IL Assembler).

중첩 된 제네릭 형식에 대 한 자세한 내용과 제네릭 형식 정의에서 중첩 된 제네릭 형식을 생성 하는 방법에 대 한 자세한 내용은을 참조 하십시오 MakeGenericType .For information on nested generic types, and on constructing nested generic types from their generic type definitions, see MakeGenericType.

추가 정보

적용 대상