Type.GetMember 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
현재 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 멤버의 이름이 포함된 문자열입니다.
반환
지정된 이름의 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메서드는 사전순 또는 선언 순서와 같은 특정 순서로 멤버를 반환 하지 않습니다. 코드가 반환 되는 순서에 따라 달라 지는 것은 아닙니다.
이 메서드 오버 로드는 클래스 이니셜라이저 (정적 생성자)를 찾지 않습니다. 클래스 이니셜라이저를 찾으려면를 사용 하는 오버 로드를 사용 하 BindingFlags 고 BindingFlags.Static Visual Basic에서 |를 지정 BindingFlags.NonPublic BindingFlags.Static Or
BindingFlags.NonPublic 합니다. 속성을 사용 하 여 클래스 이니셜라이저를 가져올 수도 있습니다 TypeInitializer .
다음 표에서는 Get
형식에 대해 리플렉션할 때 메서드에서 반환 되는 기본 클래스의 멤버를 보여 줍니다.
멤버 형식 | 정적 | 비정적 |
---|---|---|
생성자 | 아니요 | 아니요 |
필드 | 아니요 | 예. 필드는 항상 이름 및 시그니처로 숨겨집니다. |
이벤트 | 해당 없음 | 공용 형식 시스템 규칙은 상속이 속성을 구현 하는 메서드와 동일 하다는 것입니다. 리플렉션에서는 속성을 이름으로 숨기기-서명으로 처리 합니다. 아래의 참고 2를 참조 하세요. |
메서드 | 아니요 | 예. 메서드 (가상 및 비가상)는 이름을 기준으로 숨기 거 나 이름에 따라 숨길 수 있습니다. |
중첩 형식 | 아니요 | 아니요 |
속성 | 해당 없음 | 공용 형식 시스템 규칙은 상속이 속성을 구현 하는 메서드와 동일 하다는 것입니다. 리플렉션에서는 속성을 이름으로 숨기기-서명으로 처리 합니다. 아래의 참고 2를 참조 하세요. |
이름 및 시그니처는 사용자 지정 한정자, 반환 형식, 매개 변수 형식, 센티널 및 관리 되지 않는 호출 규칙을 포함 하 여 시그니처의 모든 부분을 고려 합니다. 이는 이진 비교입니다.
리플렉션의 경우 속성과 이벤트는 이름 및 시그니처로 숨겨집니다. 기본 클래스에 get 및 set 접근자가 모두 포함 된 속성이 있지만 파생 클래스에 get 접근자만 있는 경우 파생 클래스 속성은 기본 클래스 속성을 숨기고 기본 클래스의 setter에 액세스할 수 없게 됩니다.
사용자 지정 특성은 공용 형식 시스템의 일부가 아닙니다.
현재 Type 이 생성 된 제네릭 형식을 나타내는 경우이 메서드는 MemberInfo 형식 매개 변수를 적절 한 형식 인수로 대체 한를 반환 합니다.
현재 Type 이 제네릭 형식 또는 제네릭 메서드 정의의 형식 매개 변수를 나타내는 경우이 메서드는 클래스 제약 조건의 멤버나 Object 클래스 제약 조건이 없는 경우의 멤버를 검색 합니다.
참고
제네릭 메서드의 경우에 형식 인수를 포함 하지 마십시오 name
. 예를 들어 c # 코드는 GetMember("MyMethod<int>")
MyMethod<int>
MyMethod
형식의 제네릭 인수 하나를 포함 하는 라는 메서드가 아니라 텍스트 이름이 "" 인 멤버를 검색 int
합니다.
추가 정보
- MemberInfo
- String
- DefaultBinder
- GetMembers()
- GetDefaultMembers()
- FindMembers(MemberTypes, BindingFlags, MemberFilter, Object)
적용 대상
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
가져올 멤버의 이름이 포함된 문자열입니다.
반환
지정된 이름의 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를 참조하세요.
이 메서드 오버 로드를 사용 하 여 클래스 이니셜라이저 (정적 생성자)를 가져오려면에 대해 "정적 생성자"를 지정 하 name
고 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
합니다.
추가 정보
- MemberInfo
- String
- BindingFlags
- DefaultBinder
- GetMembers()
- GetDefaultMembers()
- FindMembers(MemberTypes, BindingFlags, MemberFilter, Object)
적용 대상
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
검색할 값입니다.
반환
지정된 이름의 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
합니다.
추가 정보
- MemberInfo
- String
- BindingFlags
- DefaultBinder
- GetMembers()
- GetDefaultMembers()
- FindMembers(MemberTypes, BindingFlags, MemberFilter, Object)