Type.InvokeMember 메서드

참조

정의

네임스페이스:: System

어셈블리:: System.Runtime.dll

어셈블리:: netstandard.dll

어셈블리:: mscorlib.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

현재 Type의 특정 멤버를 호출합니다.

오버로드

InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])	파생 클래스에서 재정의되면, 지정된 바인딩 제약 조건과 지정된 인수 목록, 한정자 및 문화권을 사용하여 지정된 멤버를 호출합니다.
InvokeMember(String, BindingFlags, Binder, Object, Object[], CultureInfo)	지정된 바인딩 제약 조건과 지정된 인수 목록 및 문화권을 사용하여 지정된 멤버를 호출합니다.
InvokeMember(String, BindingFlags, Binder, Object, Object[])	지정된 바인딩 제약 조건과 인수 목록을 사용하여 지정된 멤버를 호출합니다.

InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])

파생 클래스에서 재정의되면, 지정된 바인딩 제약 조건과 지정된 인수 목록, 한정자 및 문화권을 사용하여 지정된 멤버를 호출합니다.

public:
 abstract System::Object ^ InvokeMember(System::String ^ name, System::Reflection::BindingFlags invokeAttr, System::Reflection::Binder ^ binder, System::Object ^ target, cli::array <System::Object ^> ^ args, cli::array <System::Reflection::ParameterModifier> ^ modifiers, System::Globalization::CultureInfo ^ culture, cli::array <System::String ^> ^ namedParameters);

public abstract object? InvokeMember (string name, System.Reflection.BindingFlags invokeAttr, System.Reflection.Binder? binder, object? target, object?[]? args, System.Reflection.ParameterModifier[]? modifiers, System.Globalization.CultureInfo? culture, string[]? namedParameters);

public abstract object InvokeMember (string name, System.Reflection.BindingFlags invokeAttr, System.Reflection.Binder binder, object target, object[] args, System.Reflection.ParameterModifier[] modifiers, System.Globalization.CultureInfo culture, string[] namedParameters);

abstract member InvokeMember : string * System.Reflection.BindingFlags * System.Reflection.Binder * obj * obj[] * System.Reflection.ParameterModifier[] * System.Globalization.CultureInfo * string[] -> obj

Public MustOverride Function InvokeMember (name As String, invokeAttr As BindingFlags, binder As Binder, target As Object, args As Object(), modifiers As ParameterModifier(), culture As CultureInfo, namedParameters As String()) As Object

매개 변수

name: String

호출할 생성자, 메서드, 속성 또는 필드 멤버의 이름이 포함된 문자열입니다.

또는 기본 멤버를 호출하는 빈 문자열("")입니다.

또는 IDispatch 멤버의 경우 DispID를 나타내는 문자열(예: "[DispID=3]")입니다.

invokeAttr: BindingFlags

검색 방법을 지정하는 열거형 값의 비트 조합입니다. 액세스 권한은 BindingFlags, Public, NonPublic, Private, InvokeMethod 등과 같은 GetField 중 하나가 될 수 있습니다. 조회 형식을 지정할 필요가 없습니다. 조회 형식을 생략하면 BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static이 사용됩니다.

binder: Binder

속성 집합을 정의하고 바인딩을 활성화하는 개체입니다. 이 개체는 또한 리플렉션을 통해 오버로드된 메서드를 선택할 수 있고 인수 형식을 강제 변환할 수 있으며 멤버를 호출할 수도 있습니다.

또는 DefaultBinder를 사용할 null 참조(Visual Basic에는 없음)입니다. 변수 인수를 사용하여 메서드 오버로드를 호출하려면 Binder 개체를 명시적으로 정의해야 할 수도 있습니다.

target: Object

지정한 멤버를 호출할 개체입니다.

args: Object[]

호출할 멤버에 전달하는 인수를 포함하는 배열입니다.

modifiers: ParameterModifier[]

ParameterModifier 배열에서 해당하는 요소와 연관된 특성을 나타내는 args 개체 배열입니다. 매개 변수의 관련 특성은 해당 멤버의 시그니처에 저장됩니다.

기본 바인더는 COM 구성 요소를 호출하는 경우에만 이 매개 변수를 처리합니다.

culture: CultureInfo

사용할 전역화 로캘을 나타내는 CultureInfo 개체입니다. 이 개체는 숫자 String을 Double로 변환하는 등의 로캘 관련 변환에 사용할 수 있습니다.

또는 현재 스레드의 Nothing를 사용하려면 null 참조(Visual Basic의 경우 CultureInfo)입니다.

namedParameters: String[]

args 배열의 값이 전달될 매개 변수의 이름이 있는 배열입니다.

반환

Object

호출된 멤버의 반환 값을 나타내는 개체입니다.

구현

InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]) InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])

예외

ArgumentNullException

invokeAttr에 CreateInstance가 포함되어 있지 않으며 name이 null입니다.

ArgumentException

args와 modifiers의 길이가 동일하지 않습니다.

또는 invokeAttr 이 올바른 BindingFlags 특성이 아닙니다.

또는 invokeAttr 에 InvokeMethod, CreateInstance, GetField, SetField, GetProperty또는 SetProperty바인딩 플래그 중 하나가 포함되어 있지 않습니다.

또는 invokeAttr 에 CreateInstance , InvokeMethod, GetField, SetField또는 GetProperty와 결합된 SetProperty가 포함되어 있습니다.

또는 invokeAttr 에 GetField 와 SetField가 둘 다 포함되어 있습니다.

또는 invokeAttr 에 GetProperty 와 SetProperty가 둘 다 포함되어 있습니다.

또는 invokeAttr 에 InvokeMethod 또는 SetField 와 결합된 SetProperty가 포함되어 있습니다.

또는 invokeAttr 에 SetField 가 포함되어 있으며 args 에 둘 이상의 요소가 있습니다.

또는 명명된 매개 변수 배열이 인수 배열보다 큽니다.

또는 이 메서드가 COM 개체에 대해 호출되고 다음 바인딩 플래그 중 하나가 BindingFlags.InvokeMethod, BindingFlags.GetProperty, BindingFlags.SetProperty, BindingFlags.PutDispProperty 또는 BindingFlags.PutRefDispProperty로 전달되지 않았습니다.

또는 명명된 매개 변수 배열 중 하나에 null인 문자열이 포함되어 있습니다.

MethodAccessException

지정된 멤버가 클래스 이니셜라이저입니다.

MissingFieldException

필드 또는 속성을 찾을 수 없습니다.

MissingMethodException

args의 인수와 일치하는 메서드를 찾을 수 없습니다.

또는 인수 이름이 제공된 멤버를 namedParameters에서 찾을 수 없습니다.

또는 현재 Type 개체가 개방형 매개 변수를 포함하는 형식, 즉, ContainsGenericParameters가 true를 반환하는 형식을 나타냅니다.

TargetException

지정된 멤버를 target에 대해 호출할 수 없습니다.

AmbiguousMatchException

두 개 이상의 메서드가 바인딩 기준과 일치합니다.

InvalidOperationException

name이 나타내는 메서드에 두 개 이상의 제네릭 형식 매개 변수가 지정되지 않았습니다. 즉, 메서드의 ContainsGenericParameters 속성이 true를 반환합니다.

설명

InvokeMember 생성자 멤버나 메서드 멤버를 호출 하거나, 속성 멤버를 가져오거나 설정 하거나, 데이터 필드 멤버를 가져오거나 설정 하거나, 배열 멤버의 요소를 가져오거나 설정 합니다.

참고

InvokeMember를 사용 하 여 제네릭 메서드를 호출할 수 없습니다.

멤버를 호출 하는 경우 IDispatch "[DispID = # #]" 문자열 형식을 사용 하 여 멤버 이름 대신 DispID를 지정할 수 있습니다. 예를 들어 MyComMethod의 DispID가 3 인 경우 "MyComMethod" 대신 "[DispID = 3]" 문자열을 지정할 수 있습니다. DispID로 멤버를 호출 하는 것이 이름으로 멤버를 조회 하는 것 보다 빠릅니다. 복합 집계 시나리오에서 DispID는 때때로 원하는 멤버를 호출 하는 유일한 방법입니다.

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

namedParameters 배열의 각 매개 변수는 args 배열의 해당 요소에 있는 값을 가져옵니다. args의 길이가 namedParameters의 길이보다 크면 남은 인수 값이 순서대로 전달됩니다.

namedParameters배열을 사용 하 여 입력 배열의 인수 순서를 변경할 수 있습니다. 예를 들어 메서드 M(string a, int b) ( M(ByVal a As String, ByVal b As Integer) Visual Basic)와 입력 배열의 { 42, "x" } args 경우 배열이 { "b", "a" } 에 제공 되는 경우 입력 배열을 변경 되지 않은 상태로에 전달할 수 있습니다 namedParameters .

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

BindingFlags.Public공용 멤버를 검색에 포함 하도록 지정 합니다.
BindingFlags.NonPublic검색에서 public이 아닌 멤버 (즉, private, internal 및 protected 멤버)를 포함 하도록 지정 합니다.
BindingFlags.FlattenHierarchy계층의 정적 멤버를 포함 하도록 지정 합니다.

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

BindingFlags.IgnoreCase 의 대/소문자를 무시 하려면입니다 name .
BindingFlags.DeclaredOnly 단순히 상속 된 멤버가 아니라에 선언 된 멤버만 검색 합니다 Type .

다음 BindingFlags 호출 플래그를 사용 하 여 멤버와 함께 수행할 작업을 나타낼 수 있습니다.

CreateInstance 생성자를 호출 하려면입니다. name는 무시됩니다. 다른 호출 플래그와 함께 사용할 수 없습니다.
InvokeMethod 생성자 또는 형식 이니셜라이저가 아닌 메서드를 호출 합니다. 또는와 함께 사용할 수 없습니다 SetField SetProperty . 를 InvokeMethod 단독으로 지정 하면, BindingFlags.Public BindingFlags.Instance 및가 BindingFlags.Static 자동으로 포함 됩니다.
GetField 필드의 값을 가져옵니다. 에 사용할 수 없습니다 SetField .
SetField 필드의 값을 설정 합니다. 에 사용할 수 없습니다 GetField .
GetProperty 속성을 가져옵니다. 에 사용할 수 없습니다 SetProperty .
SetProperty 속성을 설정 합니다. 에 사용할 수 없습니다 GetProperty .

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

다음 조건에 모두 해당 하는 경우 메서드가 호출 됩니다.

메서드 선언의 매개 변수 개수는 배열의 인수 수와 같습니다 args (기본 인수가 멤버에 정의 되어 있고 지정 되지 않은 경우 BindingFlags.OptionalParamBinding ).
바인더를 통해 각 인수의 형식을 매개 변수의 형식으로 변환할 수 있습니다.

바인더는 일치 하는 모든 메서드를 찾습니다. 이러한 메서드는 요청 된 바인딩 형식 ( BindingFlags 값, 등)에 따라 찾을 수 InvokeMethod GetProperty 있습니다. 메서드 집합은 바인더에 정의 된 이름, 인수 개수 및 검색 한정자 집합을 기준으로 필터링 됩니다.

메서드를 선택 하면 메서드가 호출 됩니다. 해당 시점에서 액세스 가능성이 확인 됩니다. 검색은 메서드와 연결 된 접근성 특성에 따라 검색 되는 메서드 집합을 제어할 수 있습니다. Binder.BindToMethod클래스의 메서드는 Binder 호출할 메서드를 선택 합니다. 기본 바인더는 가장 구체적인 일치 항목을 선택 합니다.

InvokeMember 는 기본값을 가진 매개 변수가 있는 메서드를 호출 하는 데 사용할 수 있습니다. 이러한 메서드에 바인딩하려면 리플렉션을 BindingFlags.OptionalParamBinding 지정 해야 합니다. 기본값이 있는 매개 변수의 경우 다른 값을 제공 하거나 기본값을 사용 하도록 제공할 수 있습니다 Missing.Value .

예를 들어 MyMethod (int x, float y = 2.0)와 같은 메서드를 살펴보겠습니다. 첫 번째 인수 (4)만 사용 하 여이 메서드를 호출 하려면 위의 바인딩 플래그 중 하나를 전달 하 고 첫 번째 인수와 두 번째 인수에 대해 두 개의 인수, 즉 4를 전달 Missing.Value 합니다. 를 사용 하지 않는 경우 메서드를 사용 하 Missing.Value 여 선택적 매개 변수를 생략 하지 않을 수 있습니다 Invoke . 이 작업을 수행 해야 하는 경우 대신를 사용 InvokeMember 합니다.

완전히 신뢰할 수 있는 코드에 대 한 액세스 제한 사항은 무시 됩니다. 즉, 코드를 완전히 신뢰할 수 있는 경우에는 전용 생성자, 메서드, 필드 및 속성에 액세스 하 고 호출할 수 있습니다 System.Reflection .

Type.InvokeMember을 지정 하 여를 사용 하 여 필드를 특정 값으로 설정할 수 있습니다 BindingFlags.SetField . 예를 들어 C 클래스에서 이름이 F 인 public 인스턴스 필드를 설정 하 고, F를로 설정 하려는 경우 String 다음과 같은 코드를 사용할 수 있습니다.

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {"strings new value"}, null, null, null);

F가 인 경우 String[] 다음과 같은 코드를 사용할 수 있습니다.

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {new String[]{"a","z","c","d"}}, null, null, null);

그러면 F 필드를이 새 배열로 초기화 합니다. 를 사용 하 여 Type.InvokeMember 값의 인덱스를 제공 하 고 다음 값과 같은 코드를 사용 하 여 배열에서 위치를 설정할 수도 있습니다.

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {1, "b"}, null, null, null);

그러면 F가 문자열 "b"에 포함 하는 배열의 문자열 "z"가 변경 됩니다.

참고

2.0 서비스 팩 1 .NET Framework부터 호출자에 게 플래그가 부여 되 ReflectionPermission ReflectionPermissionFlag.RestrictedMemberAccess 고 public이 아닌 멤버의 권한 부여 집합이 호출자의 권한 부여 집합 또는 그 하위 집합으로 제한 된 경우에는이 메서드를 사용 하 여 public이 아닌 멤버에 액세스할 수 있습니다. 리플렉션의 보안 고려 사항을 참조 하세요.

이 기능을 사용 하려면 응용 프로그램이 .NET Framework 3.5 이상을 대상으로 해야 합니다.

추가 정보

적용 대상

InvokeMember(String, BindingFlags, Binder, Object, Object[], CultureInfo)

지정된 바인딩 제약 조건과 지정된 인수 목록 및 문화권을 사용하여 지정된 멤버를 호출합니다.

public:
 System::Object ^ InvokeMember(System::String ^ name, System::Reflection::BindingFlags invokeAttr, System::Reflection::Binder ^ binder, System::Object ^ target, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture);

public:
 virtual System::Object ^ InvokeMember(System::String ^ name, System::Reflection::BindingFlags invokeAttr, System::Reflection::Binder ^ binder, System::Object ^ target, cli::array <System::Object ^> ^ args, System::Globalization::CultureInfo ^ culture);

public object? InvokeMember (string name, System.Reflection.BindingFlags invokeAttr, System.Reflection.Binder? binder, object? target, object?[]? args, System.Globalization.CultureInfo? culture);

public object InvokeMember (string name, System.Reflection.BindingFlags invokeAttr, System.Reflection.Binder binder, object target, object[] args, System.Globalization.CultureInfo culture);

member this.InvokeMember : string * System.Reflection.BindingFlags * System.Reflection.Binder * obj * obj[] * System.Globalization.CultureInfo -> obj

abstract member InvokeMember : string * System.Reflection.BindingFlags * System.Reflection.Binder * obj * obj[] * System.Globalization.CultureInfo -> obj
override this.InvokeMember : string * System.Reflection.BindingFlags * System.Reflection.Binder * obj * obj[] * System.Globalization.CultureInfo -> obj

Public Function InvokeMember (name As String, invokeAttr As BindingFlags, binder As Binder, target As Object, args As Object(), culture As CultureInfo) As Object

매개 변수

name: String

호출할 생성자, 메서드, 속성 또는 필드 멤버의 이름이 포함된 문자열입니다.

또는 기본 멤버를 호출하는 빈 문자열("")입니다.

또는 IDispatch 멤버의 경우 DispID를 나타내는 문자열(예: "[DispID=3]")입니다.

invokeAttr: BindingFlags

binder: Binder

또는 Nothing를 사용하려면 null 참조(Visual Basic의 경우 DefaultBinder)입니다. 변수 인수를 사용하여 메서드 오버로드를 호출하려면 Binder 개체를 명시적으로 정의해야 할 수도 있습니다.

target: Object

지정한 멤버를 호출할 개체입니다.

args: Object[]

호출할 멤버에 전달하는 인수를 포함하는 배열입니다.

culture: CultureInfo

사용할 전역화 로캘을 나타내는 개체입니다. 이 개체는 숫자 String을 Double로 변환하는 등의 로캘별 변환에 사용할 수 있습니다.

또는 현재 스레드의 Nothing를 사용하려면 null 참조(Visual Basic의 경우 CultureInfo)입니다.

반환

Object

호출된 멤버의 반환 값을 나타내는 개체입니다.

구현

InvokeMember(String, BindingFlags, Binder, Object, Object[], CultureInfo)

예외

ArgumentNullException

invokeAttr에 CreateInstance가 포함되어 있지 않으며 name이 null입니다.

ArgumentException

invokeAttr 이 올바른 BindingFlags 특성이 아닙니다.

또는 invokeAttr 에 InvokeMethod, CreateInstance, GetField, SetField, GetProperty또는 SetProperty바인딩 플래그 중 하나가 포함되어 있지 않습니다.

또는 invokeAttr 에 CreateInstance , InvokeMethod, GetField, SetField또는 GetProperty와 결합된 SetProperty가 포함되어 있습니다.

또는 invokeAttr 에 GetField 와 SetField가 둘 다 포함되어 있습니다.

또는 invokeAttr 에 GetProperty 와 SetProperty가 둘 다 포함되어 있습니다.

또는 invokeAttr 에 InvokeMethod 또는 SetField 와 결합된 SetProperty가 포함되어 있습니다.

또는 invokeAttr 에 SetField 가 포함되어 있으며 args 에 둘 이상의 요소가 있습니다.

또는 명명된 매개 변수 배열 중 하나에 null인 문자열이 포함되어 있습니다.

MethodAccessException

지정된 멤버가 클래스 이니셜라이저입니다.

MissingFieldException

필드 또는 속성을 찾을 수 없습니다.

MissingMethodException

args의 인수와 일치하는 메서드를 찾을 수 없습니다.

또는 현재 Type 개체가 개방형 매개 변수를 포함하는 형식, 즉, ContainsGenericParameters가 true를 반환하는 형식을 나타냅니다.

TargetException

지정된 멤버를 target에 대해 호출할 수 없습니다.

AmbiguousMatchException

두 개 이상의 메서드가 바인딩 기준과 일치합니다.

InvalidOperationException

name이 나타내는 메서드에 두 개 이상의 제네릭 형식 매개 변수가 지정되지 않았습니다. 즉, 메서드의 ContainsGenericParameters 속성이 true를 반환합니다.

설명

기본 바인더는 CultureInfo ( culture 매개 변수)를 처리 하지 않지만 추상 클래스를 사용 하 여 System.Reflection.Binder 처리 하는 사용자 지정 바인더를 작성할 수 있습니다 culture .

참고

InvokeMember를 사용 하 여 제네릭 메서드를 호출할 수 없습니다.

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

BindingFlags.Public공용 멤버를 검색에 포함 하도록 지정 합니다.
BindingFlags.NonPublic검색에서 public이 아닌 멤버 (즉, private, internal 및 protected 멤버)를 포함 하도록 지정 합니다.
BindingFlags.FlattenHierarchy계층의 정적 멤버를 포함 하도록 지정 합니다.

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

BindingFlags.IgnoreCase 의 대/소문자를 무시 하려면입니다 name .
BindingFlags.DeclaredOnly 단순히 상속 된 멤버가 아니라에 선언 된 멤버만 검색 합니다 Type .

다음 BindingFlags 호출 플래그를 사용 하 여 멤버와 함께 수행할 작업을 나타낼 수 있습니다.

CreateInstance 생성자를 호출 하려면입니다. name는 무시됩니다. 다른 호출 플래그와 함께 사용할 수 없습니다.
InvokeMethod 생성자 또는 형식 이니셜라이저가 아닌 메서드를 호출 합니다. 또는와 함께 사용할 수 없습니다 SetField SetProperty . 를 InvokeMethod 단독으로 지정 하면, BindingFlags.Public BindingFlags.Instance 및가 BindingFlags.Static 자동으로 포함 됩니다.
GetField 필드의 값을 가져옵니다. 에 사용할 수 없습니다 SetField .
SetField 필드의 값을 설정 합니다. 에 사용할 수 없습니다 GetField .
GetProperty 속성을 가져옵니다. 에 사용할 수 없습니다 SetProperty .
SetProperty 속성을 설정 합니다. 에 사용할 수 없습니다 GetProperty .

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

다음 조건에 모두 해당 하는 경우 메서드가 호출 됩니다.

메서드 선언의 매개 변수 개수는 배열의 인수 수와 같습니다 args (기본 인수가 멤버에 정의 되어 있고 지정 되지 않은 경우 BindingFlags.OptionalParamBinding ).
바인더를 통해 각 인수의 형식을 매개 변수의 형식으로 변환할 수 있습니다.

완전히 신뢰할 수 있는 코드에 대 한 액세스 제한 사항은 무시 됩니다. 즉, 코드가 완전히 신뢰 될 때마다 리플렉션을 통해 전용 생성자, 메서드, 필드 및 속성에 액세스 하 고 호출할 수 있습니다.

Type.InvokeMember을 지정 하 여를 사용 하 여 필드를 특정 값으로 설정할 수 있습니다 BindingFlags.SetField . 예를 들어 클래스 C에서 이름이 F 인 public 인스턴스 필드를 설정 하려는 경우 F가 인 경우 String 와 같은 코드를 사용할 수 있습니다.

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {"strings new value"}, null);

F가 인 경우 String[] 다음과 같은 코드를 사용할 수 있습니다.

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {new String[]{"a","z","c","d"}}, null);

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {1, "b"}, null);

그러면 F가 문자열 "b"에 포함 하는 배열의 문자열 "z"가 변경 됩니다.

참고

이 기능을 사용 하려면 응용 프로그램이 .NET Framework 3.5 이상을 대상으로 해야 합니다.

추가 정보

적용 대상

InvokeMember(String, BindingFlags, Binder, Object, Object[])

지정된 바인딩 제약 조건과 인수 목록을 사용하여 지정된 멤버를 호출합니다.

public:
 System::Object ^ InvokeMember(System::String ^ name, System::Reflection::BindingFlags invokeAttr, System::Reflection::Binder ^ binder, System::Object ^ target, cli::array <System::Object ^> ^ args);

public:
 virtual System::Object ^ InvokeMember(System::String ^ name, System::Reflection::BindingFlags invokeAttr, System::Reflection::Binder ^ binder, System::Object ^ target, cli::array <System::Object ^> ^ args);

public object? InvokeMember (string name, System.Reflection.BindingFlags invokeAttr, System.Reflection.Binder? binder, object? target, object?[]? args);

public object InvokeMember (string name, System.Reflection.BindingFlags invokeAttr, System.Reflection.Binder binder, object target, object[] args);

member this.InvokeMember : string * System.Reflection.BindingFlags * System.Reflection.Binder * obj * obj[] -> obj

abstract member InvokeMember : string * System.Reflection.BindingFlags * System.Reflection.Binder * obj * obj[] -> obj
override this.InvokeMember : string * System.Reflection.BindingFlags * System.Reflection.Binder * obj * obj[] -> obj

Public Function InvokeMember (name As String, invokeAttr As BindingFlags, binder As Binder, target As Object, args As Object()) As Object

매개 변수

name: String

호출할 생성자, 메서드, 속성 또는 필드 멤버의 이름이 포함된 문자열입니다.

또는 기본 멤버를 호출하는 빈 문자열("")입니다.

또는 IDispatch 멤버의 경우 DispID를 나타내는 문자열(예: "[DispID=3]")입니다.

invokeAttr: BindingFlags

binder: Binder

target: Object

지정한 멤버를 호출할 개체입니다.

args: Object[]

호출할 멤버에 전달하는 인수를 포함하는 배열입니다.

반환

Object

호출된 멤버의 반환 값을 나타내는 개체입니다.

구현

InvokeMember(String, BindingFlags, Binder, Object, Object[])

예외

ArgumentNullException

invokeAttr에 CreateInstance가 포함되어 있지 않으며 name이 null입니다.

ArgumentException

invokeAttr 이 올바른 BindingFlags 특성이 아닙니다.

또는 invokeAttr 에 InvokeMethod, CreateInstance, GetField, SetField, GetProperty또는 SetProperty바인딩 플래그 중 하나가 포함되어 있지 않습니다.

또는 invokeAttr 에 CreateInstance , InvokeMethod, GetField, SetField또는 GetProperty와 결합된 SetProperty가 포함되어 있습니다.

또는 invokeAttr 에 GetField 와 SetField가 둘 다 포함되어 있습니다.

또는 invokeAttr 에 GetProperty 와 SetProperty가 둘 다 포함되어 있습니다.

또는 invokeAttr 에 InvokeMethod 또는 SetField 와 결합된 SetProperty가 포함되어 있습니다.

또는 invokeAttr 에 SetField 가 포함되어 있으며 args 에 둘 이상의 요소가 있습니다.

또는 명명된 매개 변수 배열 중 하나에 null인 문자열이 포함되어 있습니다.

MethodAccessException

지정된 멤버가 클래스 이니셜라이저입니다.

MissingFieldException

필드 또는 속성을 찾을 수 없습니다.

MissingMethodException

args의 인수와 일치하는 메서드를 찾을 수 없습니다.

또는 현재 Type 개체가 개방형 매개 변수를 포함하는 형식, 즉, ContainsGenericParameters가 true를 반환하는 형식을 나타냅니다.

TargetException

지정된 멤버를 target에 대해 호출할 수 없습니다.

AmbiguousMatchException

두 개 이상의 메서드가 바인딩 기준과 일치합니다.

NotSupportedException

.NET Compact Framework에서는 현재 이 메서드를 지원하지 않습니다.

InvalidOperationException

name이 나타내는 메서드에 두 개 이상의 제네릭 형식 매개 변수가 지정되지 않았습니다. 즉, 메서드의 ContainsGenericParameters 속성이 true를 반환합니다.

예제

다음 예제에서는 를 사용하여 InvokeMember 형식의 멤버에 액세스합니다.

using namespace System;
using namespace System::Reflection;

// This sample class has a field, constructor, method, and property.
ref class MyType
{
private:
   Int32 myField;

public:
   MyType( interior_ptr<Int32> x )
   {
       *x *= 5;
   }

   virtual String^ ToString() override
   {
      return myField.ToString();
   }

   property Int32 MyProp 
   {
      Int32 get()
      {
         return myField;
      }

      void set( Int32 value )
      {
         if ( value < 1 )
                  throw gcnew ArgumentOutOfRangeException( "value",value,"value must be > 0" );

         myField = value;
      }
   }
};

int main()
{
   Type^ t = MyType::typeid;

   // Create an instance of a type.
   array<Object^>^args = {8};
   Console::WriteLine( "The value of x before the constructor is called is {0}.", args[ 0 ] );
   Object^ obj = t->InvokeMember( nullptr, static_cast<BindingFlags>(BindingFlags::DeclaredOnly | BindingFlags::Public | BindingFlags::NonPublic | BindingFlags::Instance | BindingFlags::CreateInstance), nullptr, nullptr, args );
   Console::WriteLine( "Type: {0}", obj->GetType() );
   Console::WriteLine( "The value of x after the constructor returns is {0}.", args[ 0 ] );

   // Read and write to a field.
   array<Object^>^obj5 = {5};
   t->InvokeMember( "myField", static_cast<BindingFlags>(BindingFlags::DeclaredOnly | BindingFlags::Public | BindingFlags::NonPublic | BindingFlags::Instance | BindingFlags::SetField), nullptr, obj, obj5 );
   Int32 v = safe_cast<Int32>(t->InvokeMember( "myField", static_cast<BindingFlags>(BindingFlags::DeclaredOnly | BindingFlags::Public | BindingFlags::NonPublic | BindingFlags::Instance | BindingFlags::GetField), nullptr, obj, nullptr ));
   Console::WriteLine( "myField: {0}", v );

   // Call a method.
   String^ s = safe_cast<String^>(t->InvokeMember( "ToString", static_cast<BindingFlags>(BindingFlags::DeclaredOnly | BindingFlags::Public | BindingFlags::NonPublic | BindingFlags::Instance | BindingFlags::InvokeMethod), nullptr, obj, nullptr ));
   Console::WriteLine( "ToString: {0}", s );

   // Read and write a property. First, attempt to assign an
   // invalid value; then assign a valid value; finally, get
   // the value.
   try
   {
      // Assign the value zero to MyProp. The Property Set 
      // throws an exception, because zero is an invalid value.
      // InvokeMember catches the exception, and throws 
      // TargetInvocationException. To discover the real cause
      // you must catch TargetInvocationException and examine
      // the inner exception. 
      array<Object^>^obj0 = {(int^)0};
      t->InvokeMember( "MyProp", static_cast<BindingFlags>(BindingFlags::DeclaredOnly | BindingFlags::Public | BindingFlags::NonPublic | BindingFlags::Instance | BindingFlags::SetProperty), nullptr, obj, obj0 );
   }
   catch ( TargetInvocationException^ e ) 
   {
      // If the property assignment failed for some unexpected
      // reason, rethrow the TargetInvocationException.
      if ( e->InnerException->GetType() != ArgumentOutOfRangeException::typeid )
            throw;

      Console::WriteLine( "An invalid value was assigned to MyProp." );
   }

   array<Object^>^obj2 = {2};
   t->InvokeMember( "MyProp", static_cast<BindingFlags>(BindingFlags::DeclaredOnly | BindingFlags::Public | BindingFlags::NonPublic | BindingFlags::Instance | BindingFlags::SetProperty), nullptr, obj, obj2 );
   v =  safe_cast<Int32>(t->InvokeMember( "MyProp", static_cast<BindingFlags>(BindingFlags::DeclaredOnly | BindingFlags::Public | BindingFlags::NonPublic | BindingFlags::Instance | BindingFlags::GetProperty), nullptr, obj, nullptr ));
   Console::WriteLine( "MyProp: {0}", v );
}

using System;
using System.Reflection;

// This sample class has a field, constructor, method, and property.
class MyType
{
    Int32 myField;
    public MyType(ref Int32 x) {x *= 5;}
    public override String ToString() {return myField.ToString();}
    public Int32 MyProp
    {
        get {return myField;}
        set
        {
            if (value < 1)
                throw new ArgumentOutOfRangeException("value", value, "value must be > 0");
            myField = value;
        }
    }
}

class MyApp
{
    static void Main()
    {
        Type t = typeof(MyType);
        // Create an instance of a type.
        Object[] args = new Object[] {8};
        Console.WriteLine("The value of x before the constructor is called is {0}.", args[0]);
        Object obj = t.InvokeMember(null,
            BindingFlags.DeclaredOnly |
            BindingFlags.Public | BindingFlags.NonPublic |
            BindingFlags.Instance | BindingFlags.CreateInstance, null, null, args);
        Console.WriteLine("Type: " + obj.GetType().ToString());
        Console.WriteLine("The value of x after the constructor returns is {0}.", args[0]);

        // Read and write to a field.
        t.InvokeMember("myField",
            BindingFlags.DeclaredOnly |
            BindingFlags.Public | BindingFlags.NonPublic |
            BindingFlags.Instance | BindingFlags.SetField, null, obj, new Object[] {5});
        Int32 v = (Int32) t.InvokeMember("myField",
            BindingFlags.DeclaredOnly |
            BindingFlags.Public | BindingFlags.NonPublic |
            BindingFlags.Instance | BindingFlags.GetField, null, obj, null);
        Console.WriteLine("myField: " + v);

        // Call a method.
        String s = (String) t.InvokeMember("ToString",
            BindingFlags.DeclaredOnly |
            BindingFlags.Public | BindingFlags.NonPublic |
            BindingFlags.Instance | BindingFlags.InvokeMethod, null, obj, null);
        Console.WriteLine("ToString: " + s);

        // Read and write a property. First, attempt to assign an
        // invalid value; then assign a valid value; finally, get
        // the value.
        try
        {
            // Assign the value zero to MyProp. The Property Set
            // throws an exception, because zero is an invalid value.
            // InvokeMember catches the exception, and throws
            // TargetInvocationException. To discover the real cause
            // you must catch TargetInvocationException and examine
            // the inner exception.
            t.InvokeMember("MyProp",
                BindingFlags.DeclaredOnly |
                BindingFlags.Public | BindingFlags.NonPublic |
                BindingFlags.Instance | BindingFlags.SetProperty, null, obj, new Object[] {0});
        }
        catch (TargetInvocationException e)
        {
            // If the property assignment failed for some unexpected
            // reason, rethrow the TargetInvocationException.
            if (e.InnerException.GetType() !=
                typeof(ArgumentOutOfRangeException))
                throw;
            Console.WriteLine("An invalid value was assigned to MyProp.");
        }
        t.InvokeMember("MyProp",
            BindingFlags.DeclaredOnly |
            BindingFlags.Public | BindingFlags.NonPublic |
            BindingFlags.Instance | BindingFlags.SetProperty, null, obj, new Object[] {2});
        v = (Int32) t.InvokeMember("MyProp",
            BindingFlags.DeclaredOnly |
            BindingFlags.Public | BindingFlags.NonPublic |
            BindingFlags.Instance | BindingFlags.GetProperty, null, obj, null);
        Console.WriteLine("MyProp: " + v);
    }
}

Imports System.Reflection

' This sample class has a field, constructor, method, and property.
Class MyType
    Private myField As Int32

    Public Sub New(ByRef x As Int32)
        x *= 5
    End Sub

    Public Overrides Function ToString() As [String]
        Return myField.ToString()
    End Function 'ToString

    Public Property MyProp() As Int32
        Get
            Return myField
        End Get
        Set(ByVal Value As Int32)
            If Value < 1 Then
                Throw New ArgumentOutOfRangeException("value", Value, "value must be > 0")
            End If
            myField = Value
        End Set
    End Property
End Class

Class MyApp

    Shared Sub Main()
        Dim t As Type = GetType(MyType)
        ' Create an instance of a type.
        Dim args() As [Object] = {8}
        Console.WriteLine("The value of x before the constructor is called is {0}.", args(0))
        Dim obj As [Object] = t.InvokeMember(Nothing, BindingFlags.DeclaredOnly Or BindingFlags.Public Or BindingFlags.NonPublic Or BindingFlags.Instance Or BindingFlags.CreateInstance, Nothing, Nothing, args)
        Console.WriteLine("Type: {0}", obj.GetType().ToString())
        Console.WriteLine("The value of x after the constructor returns is {0}.", args(0))

        ' Read and write to a field.
        t.InvokeMember("myField", BindingFlags.DeclaredOnly Or BindingFlags.Public Or BindingFlags.NonPublic Or BindingFlags.Instance Or BindingFlags.SetField, Nothing, obj, New [Object]() {5})
        Dim v As Int32 = CType(t.InvokeMember("myField", BindingFlags.DeclaredOnly Or BindingFlags.Public Or BindingFlags.NonPublic Or BindingFlags.Instance Or BindingFlags.GetField, Nothing, obj, Nothing), Int32)
        Console.WriteLine("myField: {0}", v)

        ' Call a method.
        Dim s As [String] = CType(t.InvokeMember("ToString", BindingFlags.DeclaredOnly Or BindingFlags.Public Or BindingFlags.NonPublic Or BindingFlags.Instance Or BindingFlags.InvokeMethod, Nothing, obj, Nothing), [String])
        Console.WriteLine("ToString: {0}", s)

        ' Read and write a property. First, attempt to assign an
        ' invalid value; then assign a valid value; finally, get
        ' the value.
        Try
            ' Assign the value zero to MyProp. The Property Set 
            ' throws an exception, because zero is an invalid value.
            ' InvokeMember catches the exception, and throws 
            ' TargetInvocationException. To discover the real cause
            ' you must catch TargetInvocationException and examine
            ' the inner exception. 
            t.InvokeMember("MyProp", BindingFlags.DeclaredOnly Or BindingFlags.Public Or BindingFlags.NonPublic Or BindingFlags.Instance Or BindingFlags.SetProperty, Nothing, obj, New [Object]() {0})
        Catch e As TargetInvocationException
            ' If the property assignment failed for some unexpected
            ' reason, rethrow the TargetInvocationException.
            If Not e.InnerException.GetType() Is GetType(ArgumentOutOfRangeException) Then
                Throw
            End If
            Console.WriteLine("An invalid value was assigned to MyProp.")
        End Try
        t.InvokeMember("MyProp", BindingFlags.DeclaredOnly Or BindingFlags.Public Or BindingFlags.NonPublic Or BindingFlags.Instance Or BindingFlags.SetProperty, Nothing, obj, New [Object]() {2})
        v = CType(t.InvokeMember("MyProp", BindingFlags.DeclaredOnly Or BindingFlags.Public Or BindingFlags.NonPublic Or BindingFlags.Instance Or BindingFlags.GetProperty, Nothing, obj, Nothing), Int32)
        Console.WriteLine("MyProp: {0}", v)
    End Sub
End Class

설명

참고

를 사용하여 InvokeMember 제네릭 메서드를 호출할 수 없습니다.

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

BindingFlags.Public검색에 public 멤버를 포함하도록 지정합니다.
BindingFlags.NonPublicpublic이 아닌 멤버(즉, private 및 protected 멤버)를 검색에 포함하도록 지정합니다.
BindingFlags.FlattenHierarchy계층에 정적 멤버를 포함하도록 지정합니다.

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

BindingFlags.IgnoreCase 의 대/소문자 구분을 name 무시합니다.
BindingFlags.DeclaredOnly 에 선언된 멤버만 검색하려면 Type 이고, 단순히 상속된 멤버는 검색하지 않습니다.

다음 BindingFlags 호출 플래그를 사용하여 멤버로 수행할 작업을 나타낼 수 있습니다.

CreateInstance 생성자를 호출하는 입니다. name는 무시됩니다. 다른 호출 플래그에는 유효하지 않습니다.
InvokeMethod 생성자 또는 형식 이니셜라이저가 아닌 메서드를 호출하는 입니다. 또는 에는 유효하지 SetField SetProperty 않습니다. InvokeMethod가 자체적으로 지정되면 BindingFlags.Public , 및 가 자동으로 BindingFlags.Instance BindingFlags.Static 포함됩니다.
GetField 필드의 값을 얻으려면 입니다. 에는 유효하지 SetField 않습니다.
SetField 필드의 값을 설정하려면 입니다. 에는 유효하지 GetField 않습니다.
GetProperty 속성을 얻으려면 입니다. 에는 유효하지 SetProperty 않습니다.
SetProperty 속성을 설정하려면 입니다. 에는 유효하지 GetProperty 않습니다.

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

다음 조건이 모두 충족되면 메서드가 호출됩니다.

메서드 선언의 매개 변수 수는 배열의 인수 args 수와 같습니다(기본 인수가 멤버에 정의되고 가 지정되지 않은 BindingFlags.OptionalParamBinding 경우).
각 인수의 형식은 바인더에서 매개 변수의 형식으로 변환할 수 있습니다.

바인더는 일치하는 메서드를 모두 찾습니다. 이러한 메서드는 요청된 바인딩 BindingFlags 형식(값 InvokeMethod , 등)에 따라 찾을 수 GetProperty 있습니다. 메서드 집합은 이름, 인수 수 및 바인더에 정의된 검색 한정자 집합으로 필터링됩니다.

메서드를 선택하면 메서드가 호출됩니다. 이때 접근성이 검사됩니다. 검색은 메서드와 연결된 접근성 특성에 따라 검색되는 메서드 집합을 제어할 수 있습니다. Binder.BindToMethod Binder 클래스의 메서드는 호출할 메서드를 선택해야 합니다. 기본 바인더는 가장 구체적인 일치를 선택합니다.

완전히 신뢰할 수 있는 코드에 대한 액세스 제한은 무시됩니다. 즉, 코드를 완전히 신뢰할 수 있을 때마다 프라이빗 생성자, 메서드, 필드 및 속성을 통해 액세스하고 호출할 수 System.Reflection 있습니다.

를 사용하여 Type.InvokeMember 를 지정하여 필드를 특정 값으로 설정할 수 BindingFlags.SetField 있습니다. 예를 들어 C 클래스에서 F라는 공용 인스턴스 필드를 설정하고 F가 인 경우 String 다음과 같은 코드를 사용할 수 있습니다.

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {"strings new value"});

F가 이면 String[] 다음과 같은 코드를 사용할 수 있습니다.

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {new String[]{"a","z","c","d"}});

필드 F를 이 새 배열로 초기화합니다. 를 사용하여 Type.InvokeMember 값의 인덱스 및 다음 값(예: 코드)을 제공하여 배열의 위치를 설정할 수도 있습니다.

typeof(C).InvokeMember("F", BindingFlags.SetField, null, c, new Object[] {1, "b"});

그러면 F가 보유하는 배열의 문자열 "z"가 문자열 "b"로 변경됩니다.

멤버를 호출할 때 IDispatch "[DispID=##]" 문자열 형식을 사용하여 멤버 이름 대신 DispID를 지정할 수 있습니다. 예를 들어 MyComMethod의 DispID가 3인 경우 "MyComMethod" 대신 "[DispID=3]" 문자열을 지정할 수 있습니다. DispID로 멤버를 호출하는 것은 멤버를 이름으로 찾는 것보다 빠릅니다. 복잡한 집계 시나리오에서 DispID는 경우에 따라 원하는 멤버를 호출하는 유일한 방법입니다.

참고

.NET Framework 2.0 서비스 팩 1부터 이 메서드는 호출자가 플래그를 사용하여 부여된 경우 및 public이 아닌 ReflectionPermission ReflectionPermissionFlag.RestrictedMemberAccess 멤버의 권한 부여 집합이 호출자의 권한 부여 집합 또는 해당 하위 집합으로 제한되는 경우 public이 아닌 멤버에 액세스하는 데 사용할 수 있습니다. 리플렉션에 대한 보안 고려 사항을참조하세요.

이 기능을 사용하려면 애플리케이션이 .NET Framework 3.5 이상이어야 합니다.

추가 정보

적용 대상