다음을 통해 공유


Type.GetMember 메서드

정의

현재 Type의 지정된 멤버를 가져옵니다.

오버로드

GetMember(String)

지정된 이름의 public 멤버를 검색합니다.

GetMember(String, BindingFlags)

지정된 멤버를 지정된 바인딩 제약 조건으로 검색합니다.

GetMember(String, MemberTypes, BindingFlags)

지정된 멤버 형식의 지정된 멤버를 지정된 바인딩 제약 조건으로 검색합니다.

GetMember(String)

지정된 이름의 public 멤버를 검색합니다.

public:
 cli::array <System::Reflection::MemberInfo ^> ^ GetMember(System::String ^ name);
public:
 virtual cli::array <System::Reflection::MemberInfo ^> ^ GetMember(System::String ^ name);
public System.Reflection.MemberInfo[] GetMember (string name);
member this.GetMember : string -> System.Reflection.MemberInfo[]
abstract member GetMember : string -> System.Reflection.MemberInfo[]
override this.GetMember : string -> System.Reflection.MemberInfo[]
Public Function GetMember (name As String) As MemberInfo()

매개 변수

name
String

가져올 public 멤버의 이름이 포함된 문자열입니다.

반환

MemberInfo[]

지정된 이름의 public 멤버가 있으면 이를 나타내는 MemberInfo 개체의 배열이고, 그렇지 않으면 빈 배열입니다.

구현

예외

name이(가) null인 경우

예제

다음 예제에서는 String C 문자로 시작 하는 클래스의 모든 멤버를 표시 합니다.

using namespace System;
using namespace System::Security;
using namespace System::Reflection;

// forward declarations:
void GetMemberInfo();
void GetPublicStaticMemberInfo();
void GetPublicInstanceMethodMemberInfo();
int main()
{
   try
   {
      GetMemberInfo();
      GetPublicStaticMemberInfo();
      GetPublicInstanceMethodMemberInfo();
   }
   catch ( ArgumentNullException^ e ) 
   {
      Console::WriteLine( "ArgumentNullException occurred." );
      Console::WriteLine( "Source: {0}", e->Source );
      Console::WriteLine( "Message: {0}", e->Message );
   }
   catch ( NotSupportedException^ e ) 
   {
      Console::WriteLine( "NotSupportedException occurred." );
      Console::WriteLine( "Source: {0}", e->Source );
      Console::WriteLine( "Message: {0}", e->Message );
   }
   catch ( SecurityException^ e ) 
   {
      Console::WriteLine( "SecurityException occurred." );
      Console::WriteLine( "Source: {0}", e->Source );
      Console::WriteLine( "Message: {0}", e->Message );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception occurred." );
      Console::WriteLine( "Source: {0}", e->Source );
      Console::WriteLine( "Message: {0}", e->Message );
   }

}

void GetMemberInfo()
{
   String^ myString = "GetMember_String";
   Type^ myType = myString->GetType();
   
   // Get the members for myString starting with the letter C.
   array<MemberInfo^>^myMembers = myType->GetMember( "C*" );
   if ( myMembers->Length > 0 )
   {
      Console::WriteLine( "\nThe member(s) starting with the letter C for type {0}:", myType );
      for ( int index = 0; index < myMembers->Length; index++ )
         Console::WriteLine( "Member {0}: {1}", index + 1, myMembers[ index ] );
   }
   else
      Console::WriteLine( "No members match the search criteria." );
}

using System;
using System.Security;
using System.Reflection;

public class MyMemberSample
{
    public static void Main()
    {
        MyMemberSample myClass = new MyMemberSample();
        try
        {
            myClass.GetMemberInfo();
            myClass.GetPublicStaticMemberInfo();	
            myClass.GetPublicInstanceMethodMemberInfo();	
        }
        catch(ArgumentNullException e)
        {
            Console.WriteLine("ArgumentNullException occurred.");
            Console.WriteLine("Source: " + e.Source);
            Console.WriteLine("Message: " + e.Message);
        }
        catch(NotSupportedException e)
        {
            Console.WriteLine("NotSupportedException occurred.");
            Console.WriteLine("Source: " + e.Source);
            Console.WriteLine("Message: " + e.Message);
        }
        catch(SecurityException e)
        {
            Console.WriteLine("SecurityException occurred.");
            Console.WriteLine("Source: " + e.Source);
            Console.WriteLine("Message: " + e.Message);
        }
        catch(Exception e)
        {
            Console.WriteLine("Exception occurred.");
            Console.WriteLine("Source: " + e.Source);
            Console.WriteLine("Message: " + e.Message);
        }
    }

    public void GetMemberInfo()
    {
        String myString = "GetMember_String";

        Type myType = myString.GetType();
        // Get the members for myString starting with the letter C.
        MemberInfo[] myMembers = myType.GetMember("C*");
        if(myMembers.Length > 0)
        {
            Console.WriteLine("\nThe member(s) starting with the letter C for type {0}:", myType);
            for(int index=0; index < myMembers.Length; index++)
                Console.WriteLine("Member {0}: {1}", index + 1, myMembers[index].ToString());
        }
        else
        {
            Console.WriteLine("No members match the search criteria.");
        }
    }

Imports System.Security
Imports System.Reflection

Public Class MyMemberSample

    Public Shared Sub Main()
        Dim [myClass] As New MyMemberSample()
        Try
            [myClass].GetMemberInfo()
            [myClass].GetPublicStaticMemberInfo()
            [myClass].GetPublicInstanceMethodMemberInfo()
        Catch e As ArgumentNullException
            Console.WriteLine("ArgumentNullException occurred.")
            Console.WriteLine(("Source: " + e.Source))
            Console.WriteLine(("Message: " + e.Message))
        Catch e As NotSupportedException
            Console.WriteLine("NotSupportedException occurred.")
            Console.WriteLine(("Source: " + e.Source))
            Console.WriteLine(("Message: " + e.Message))
        Catch e As SecurityException
            Console.WriteLine("SecurityException occurred.")
            Console.WriteLine(("Source: " + e.Source))
            Console.WriteLine(("Message: " + e.Message))
        Catch e As Exception
            Console.WriteLine("Exception occurred.")
            Console.WriteLine(("Source: " + e.Source))
            Console.WriteLine(("Message: " + e.Message))
        End Try
    End Sub


    Public Sub GetMemberInfo()
        Dim myString As [String] = "GetMember_String"
        Dim myType As Type = myString.GetType()
        ' Get the members for myString starting with the letter C.
        Dim myMembers As MemberInfo() = myType.GetMember("C*")
        If myMembers.Length > 0 Then
            Console.WriteLine(ControlChars.Cr + "The member(s) starting with the letter C for type {0}:", myType)
            Dim index As Integer
            For index = 0 To myMembers.Length - 1
                Console.WriteLine("Member {0}: {1}", index + 1, myMembers(index).ToString())
            Next index
        Else
            Console.WriteLine("No members match the search criteria.")
        End If
    End Sub

설명

검색은 대 name /소문자를 구분 합니다. 검색에는 public static 및 public instance 멤버가 포함 됩니다.

멤버에는 속성, 메서드, 필드, 이벤트 등이 포함 됩니다.

GetMember메서드는 사전순 또는 선언 순서와 같은 특정 순서로 멤버를 반환 하지 않습니다. 코드가 반환 되는 순서에 따라 달라 지는 것은 아닙니다.

이 메서드 오버 로드는 클래스 이니셜라이저 (정적 생성자)를 찾지 않습니다. 클래스 이니셜라이저를 찾으려면를 사용 하는 오버 로드를 사용 하 BindingFlagsBindingFlags.Static Visual Basic에서 |를 지정 BindingFlags.NonPublic BindingFlags.Static Or BindingFlags.NonPublic 합니다. 속성을 사용 하 여 클래스 이니셜라이저를 가져올 수도 있습니다 TypeInitializer .

다음 표에서는 Get 형식에 대해 리플렉션할 때 메서드에서 반환 되는 기본 클래스의 멤버를 보여 줍니다.

멤버 형식 정적 비정적
생성자 아니요 아니요
필드 아니요 예. 필드는 항상 이름 및 시그니처로 숨겨집니다.
이벤트 해당 없음 공용 형식 시스템 규칙은 상속이 속성을 구현 하는 메서드와 동일 하다는 것입니다. 리플렉션에서는 속성을 이름으로 숨기기-서명으로 처리 합니다. 아래의 참고 2를 참조 하세요.
메서드 아니요 예. 메서드 (가상 및 비가상)는 이름을 기준으로 숨기 거 나 이름에 따라 숨길 수 있습니다.
중첩 형식 아니요 아니요
속성 해당 없음 공용 형식 시스템 규칙은 상속이 속성을 구현 하는 메서드와 동일 하다는 것입니다. 리플렉션에서는 속성을 이름으로 숨기기-서명으로 처리 합니다. 아래의 참고 2를 참조 하세요.
  1. 이름 및 시그니처는 사용자 지정 한정자, 반환 형식, 매개 변수 형식, 센티널 및 관리 되지 않는 호출 규칙을 포함 하 여 시그니처의 모든 부분을 고려 합니다. 이는 이진 비교입니다.

  2. 리플렉션의 경우 속성과 이벤트는 이름 및 시그니처로 숨겨집니다. 기본 클래스에 get 및 set 접근자가 모두 포함 된 속성이 있지만 파생 클래스에 get 접근자만 있는 경우 파생 클래스 속성은 기본 클래스 속성을 숨기고 기본 클래스의 setter에 액세스할 수 없게 됩니다.

  3. 사용자 지정 특성은 공용 형식 시스템의 일부가 아닙니다.

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

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

참고

제네릭 메서드의 경우에 형식 인수를 포함 하지 마십시오 name . 예를 들어 c # 코드는 GetMember("MyMethod<int>") MyMethod<int> MyMethod 형식의 제네릭 인수 하나를 포함 하는 라는 메서드가 아니라 텍스트 이름이 "" 인 멤버를 검색 int 합니다.

추가 정보

적용 대상

GetMember(String, BindingFlags)

지정된 멤버를 지정된 바인딩 제약 조건으로 검색합니다.

public:
 virtual cli::array <System::Reflection::MemberInfo ^> ^ GetMember(System::String ^ name, System::Reflection::BindingFlags bindingAttr);
public virtual System.Reflection.MemberInfo[] GetMember (string name, System.Reflection.BindingFlags bindingAttr);
abstract member GetMember : string * System.Reflection.BindingFlags -> System.Reflection.MemberInfo[]
override this.GetMember : string * System.Reflection.BindingFlags -> System.Reflection.MemberInfo[]
Public Overridable Function GetMember (name As String, bindingAttr As BindingFlags) As MemberInfo()

매개 변수

name
String

가져올 멤버의 이름이 포함된 문자열입니다.

bindingAttr
BindingFlags

검색 방법을 지정하는 열거형 값의 비트 조합입니다.

또는 빈 배열을 반환하는 Default입니다.

반환

MemberInfo[]

지정된 이름의 public 멤버가 있으면 이를 나타내는 MemberInfo 개체의 배열이고, 그렇지 않으면 빈 배열입니다.

구현

예외

name이(가) null인 경우

예제

다음 예제에서는 myString C 문자로 시작 하는 클래스의 모든 public 정적 멤버를 표시 합니다.

void GetPublicStaticMemberInfo()
{
   String^ myString = "GetMember_String_BindingFlag";
   Type^ myType = myString->GetType();
   
   // Get the public static members for the class myString starting with the letter C
   array<MemberInfo^>^myMembers = myType->GetMember( "C*", static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Static) );
   if ( myMembers->Length > 0 )
   {
      Console::WriteLine( "\nThe public static member(s) starting with the letter C for type {0}:", myType );
      for ( int index = 0; index < myMembers->Length; index++ )
         Console::WriteLine( "Member {0}: {1}", index + 1, myMembers[ index ] );
   }
   else
      Console::WriteLine( "No members match the search criteria." );
}
public void GetPublicStaticMemberInfo()
{
    String myString = "GetMember_String_BindingFlag";
    Type myType = myString.GetType();
    // Get the public static members for the class myString starting with the letter C.
    MemberInfo[] myMembers = myType.GetMember("C*",
        BindingFlags.Public |BindingFlags.Static);
    if(myMembers.Length > 0)
    {
        Console.WriteLine("\nThe public static member(s) starting with the letter C for type {0}:", myType);
        for(int index=0; index < myMembers.Length; index++)
            Console.WriteLine("Member {0}: {1}", index + 1, myMembers[index].ToString());
    }
    else
    {
        Console.WriteLine("No members match the search criteria.");
    }
}
Public Sub GetPublicStaticMemberInfo()
    Dim myString As [String] = "GetMember_String_BindingFlag"

    Dim myType As Type = myString.GetType()
    ' Get the public static members for the class myString starting with the letter C.
    Dim myMembers As MemberInfo() = myType.GetMember("C*", BindingFlags.Public Or BindingFlags.Static)

    If myMembers.Length > 0 Then
        Console.WriteLine(ControlChars.Cr + "The public static member(s) starting with the letter C for type {0}:", myType)
        Dim index As Integer
        For index = 0 To myMembers.Length - 1
            Console.WriteLine("Member {0}: {1}", index + 1, myMembers(index).ToString())
        Next index
    Else
        Console.WriteLine("No members match the search criteria.")
    End If
End Sub

설명

이 메서드는 파생 클래스에 의해 재정의 될 수 있습니다.

멤버에는 속성, 메서드, 필드, 이벤트 등이 포함 됩니다.

GetMember메서드는 사전순 또는 선언 순서와 같은 특정 순서로 멤버를 반환 하지 않습니다. 코드가 반환 되는 순서에 따라 달라 지는 것은 아닙니다.

다음 BindingFlags 필터 플래그는 검색에 포함할 멤버를 정의 하는 데 사용할 수 있습니다.

  • BindingFlags.Instance반환을 얻으려면 또는 중 하나를 지정 해야 합니다 BindingFlags.Static .

  • BindingFlags.Public공용 멤버를 검색에 포함 하도록 지정 합니다.

  • BindingFlags.NonPublic검색에서 public이 아닌 멤버 (즉, private, internal 및 protected 멤버)를 포함 하도록 지정 합니다.

  • BindingFlags.FlattenHierarchy public 계층의 정적 멤버를 포함 하도록 지정 합니다. 상속 된 protected private 클래스의 정적 멤버는 포함 되지 않습니다.

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

  • BindingFlags.IgnoreCase 의 대/소문자를 무시 하려면입니다 name .

  • BindingFlags.DeclaredOnly 단순히 상속 된 멤버가 아니라에 선언 된 멤버만 검색 합니다 Type .

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

이 메서드 오버 로드를 사용 하 여 클래스 이니셜라이저 (정적 생성자)를 가져오려면에 대해 "정적 생성자"를 지정 하 nameBindingFlags.Static 에는 | BindingFlags.NonPublic ( BindingFlags.Static Or BindingFlags.NonPublic Visual Basic) bindingAttr 를 지정 해야 합니다. 속성을 사용 하 여 클래스 이니셜라이저를 가져올 수도 있습니다 TypeInitializer .

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

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

참고

제네릭 메서드의 경우에 형식 인수를 포함 하지 마십시오 name . 예를 들어 c # 코드는 GetMember("MyMethod<int>") MyMethod<int> MyMethod 형식의 제네릭 인수 하나를 포함 하는 라는 메서드가 아니라 텍스트 이름이 "" 인 멤버를 검색 int 합니다.

추가 정보

적용 대상

GetMember(String, MemberTypes, BindingFlags)

지정된 멤버 형식의 지정된 멤버를 지정된 바인딩 제약 조건으로 검색합니다.

public:
 virtual cli::array <System::Reflection::MemberInfo ^> ^ GetMember(System::String ^ name, System::Reflection::MemberTypes type, System::Reflection::BindingFlags bindingAttr);
public virtual System.Reflection.MemberInfo[] GetMember (string name, System.Reflection.MemberTypes type, System.Reflection.BindingFlags bindingAttr);
abstract member GetMember : string * System.Reflection.MemberTypes * System.Reflection.BindingFlags -> System.Reflection.MemberInfo[]
override this.GetMember : string * System.Reflection.MemberTypes * System.Reflection.BindingFlags -> System.Reflection.MemberInfo[]
Public Overridable Function GetMember (name As String, type As MemberTypes, bindingAttr As BindingFlags) As MemberInfo()

매개 변수

name
String

가져올 멤버의 이름이 포함된 문자열입니다.

type
MemberTypes

검색할 값입니다.

bindingAttr
BindingFlags

검색 방법을 지정하는 열거형 값의 비트 조합입니다.

또는 빈 배열을 반환하는 Default입니다.

반환

MemberInfo[]

지정된 이름의 public 멤버가 있으면 이를 나타내는 MemberInfo 개체의 배열이고, 그렇지 않으면 빈 배열입니다.

구현

예외

name이(가) null인 경우

파생 클래스에서 구현을 제공해야 합니다.

예제

다음 예제에서는 myString C 문자로 시작 하는 클래스의 모든 메서드를 표시 합니다.

void GetPublicInstanceMethodMemberInfo()
{
   String^ myString = "GetMember_String_MemberType_BindingFlag";
   Type^ myType = myString->GetType();
   
   // Get the public instance methods for myString starting with the letter C.
   array<MemberInfo^>^myMembers = myType->GetMember( "C*", MemberTypes::Method, static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance) );
   if ( myMembers->Length > 0 )
   {
      Console::WriteLine( "\nThe public instance method(s) starting with the letter C for type {0}:", myType );
      for ( int index = 0; index < myMembers->Length; index++ )
         Console::WriteLine( "Member {0}: {1}", index + 1, myMembers[ index ] );
   }
   else
      Console::WriteLine( "No members match the search criteria." );
}
    public void GetPublicInstanceMethodMemberInfo()
    {
        String myString = "GetMember_String_MemberType_BindingFlag";
        Type myType = myString.GetType();
        // Get the public instance methods for myString starting with the letter C.
        MemberInfo[] myMembers = myType.GetMember("C*", MemberTypes.Method,
            BindingFlags.Public | BindingFlags.Instance);
        if(myMembers.Length > 0)
        {
            Console.WriteLine("\nThe public instance method(s) starting with the letter C for type {0}:", myType);
            for(int index=0; index < myMembers.Length; index++)
                Console.WriteLine("Member {0}: {1}", index + 1, myMembers[index].ToString());
        }
        else
        {
            Console.WriteLine("No members match the search criteria.");
        }
    }
}
    Public Sub GetPublicInstanceMethodMemberInfo()
        Dim myString As [String] = "GetMember_String_MemberType_BindingFlag"

        Dim myType As Type = myString.GetType()
        ' Get the public instance methods for myString starting with the letter C.
        Dim myMembers As MemberInfo() = myType.GetMember("C*", MemberTypes.Method, BindingFlags.Public Or BindingFlags.Instance)
        If myMembers.Length > 0 Then
            Console.WriteLine(ControlChars.Cr + "The public instance method(s) starting with the letter C for type {0}:", myType)
            Dim index As Integer
            For index = 0 To myMembers.Length - 1
                Console.WriteLine("Member {0}: {1}", index + 1, myMembers(index).ToString())
            Next index
        Else
            Console.WriteLine("No members match the search criteria.")
        End If
    End Sub
End Class

설명

멤버에는 속성, 메서드, 필드, 이벤트 등이 포함 됩니다.

GetMember메서드는 사전순 또는 선언 순서와 같은 특정 순서로 멤버를 반환 하지 않습니다. 코드가 반환 되는 순서에 따라 달라 지는 것은 아닙니다.

다음 BindingFlags 필터 플래그는 검색에 포함할 멤버를 정의 하는 데 사용할 수 있습니다.

  • BindingFlags.Instance반환을 얻으려면 또는 중 하나를 지정 해야 합니다 BindingFlags.Static .

  • BindingFlags.Public공용 멤버를 검색에 포함 하도록 지정 합니다.

  • BindingFlags.NonPublic검색에서 public이 아닌 멤버 (즉, private, internal 및 protected 멤버)를 포함 하도록 지정 합니다.

  • BindingFlags.FlattenHierarchy public 계층의 정적 멤버를 포함 하도록 지정 합니다. 상속 된 protected private 클래스의 정적 멤버는 포함 되지 않습니다.

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

  • BindingFlags.IgnoreCase 의 대/소문자를 무시 하려면입니다 name .

  • BindingFlags.DeclaredOnly 단순히 상속 된 멤버가 아니라에 선언 된 멤버만 검색 합니다 Type .

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

이 메서드 오버 로드를 사용 하 여 클래스 이니셜라이저 (정적 생성자)를 가져오려면에 대해,에 대해 "static constructor"를 지정 하 고에는 name MemberTypes.Constructor type BindingFlags.Static | BindingFlags.NonPublic ( BindingFlags.Static Or BindingFlags.NonPublic Visual Basic) bindingAttr 를 지정 해야 합니다. 속성을 사용 하 여 클래스 이니셜라이저를 가져올 수도 있습니다 TypeInitializer .

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

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

참고

제네릭 메서드의 경우에 형식 인수를 포함 하지 마십시오 name . 예를 들어 c # 코드는 GetMember("MyMethod<int>") MyMethod<int> MyMethod 형식의 제네릭 인수 하나를 포함 하는 라는 메서드가 아니라 텍스트 이름이 "" 인 멤버를 검색 int 합니다.

추가 정보

적용 대상