Type.GetMethod 方法
定義
多載
GetMethod(String, Int32, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[]) |
使用指定的繫結限制式和指定的呼叫慣例來搜尋指定的方法,其參數符合指定的泛型參數計數、引數型別及修飾元。Searches for the specified method whose parameters match the specified generic parameter count, argument types and modifiers, using the specified binding constraints and the specified calling convention. |
GetMethod(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[]) |
使用指定的繫結條件約束和指定的呼叫慣例,來搜尋指定的方法,而該方法的參數符合指定的引數類型和修飾詞。Searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention. |
GetMethod(String, Int32, BindingFlags, Binder, Type[], ParameterModifier[]) |
使用指定的繫結限制式來搜尋指定的方法,其參數符合指定的泛型參數計數、引數型別及修飾元。Searches for the specified method whose parameters match the specified generic parameter count, argument types and modifiers, using the specified binding constraints. |
GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[]) |
使用指定的繫結條件約束搜尋指定的方法,而該方法的參數符合指定的引數類型和修飾詞。Searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints. |
GetMethod(String, Int32, Type[], ParameterModifier[]) |
搜尋指定的公用方法,其參數符合指定的泛型參數計數、引數型別及修飾元。Searches for the specified public method whose parameters match the specified generic parameter count, argument types and modifiers. |
GetMethod(String, Type[]) |
搜尋指定的公用方法,其參數符合指定的引數類型。Searches for the specified public method whose parameters match the specified argument types. |
GetMethod(String, Int32, Type[]) |
搜尋指定的公用方法,其參數符合指定的泛型參數計數和引數型別。Searches for the specified public method whose parameters match the specified generic parameter count and argument types. |
GetMethod(String, BindingFlags) |
使用指定的繫結條件約束搜尋指定的方法。Searches for the specified method, using the specified binding constraints. |
GetMethod(String) |
搜尋具有指定名稱的公用方法。Searches for the public method with the specified name. |
GetMethod(String, Type[], ParameterModifier[]) |
搜尋指定的公用方法,其參數符合指定的引數類型和修飾詞。Searches for the specified public method whose parameters match the specified argument types and modifiers. |
GetMethod(String, Int32, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
使用指定的繫結限制式和指定的呼叫慣例來搜尋指定的方法,其參數符合指定的泛型參數計數、引數型別及修飾元。Searches for the specified method whose parameters match the specified generic parameter count, argument types and modifiers, using the specified binding constraints and the specified calling convention.
public:
System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, int genericParameterCount, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, System::Reflection::CallingConventions callConvention, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);
public System.Reflection.MethodInfo GetMethod (string? name, int genericParameterCount, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, System.Reflection.CallingConventions callConvention, Type[]? types, System.Reflection.ParameterModifier[] modifiers);
public System.Reflection.MethodInfo GetMethod (string name, int genericParameterCount, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, System.Reflection.CallingConventions callConvention, Type[] types, System.Reflection.ParameterModifier[] modifiers);
member this.GetMethod : string * int * System.Reflection.BindingFlags * System.Reflection.Binder * System.Reflection.CallingConventions * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo
Public Function GetMethod (name As String, genericParameterCount As Integer, bindingAttr As BindingFlags, binder As Binder, callConvention As CallingConventions, types As Type(), modifiers As ParameterModifier()) As MethodInfo
參數
- name
- String
字串,包含要取得的公用方法名稱。The string containing the name of the public method to get.
- genericParameterCount
- Int32
方法的泛型型別參數數目。The number of generic type parameters of the method.
- bindingAttr
- BindingFlags
列舉值的位元組合,用來指定搜尋的執行方式。A bitwise combination of the enumeration values that specify how the search is conducted.
-或--or-
- binder
- Binder
定義一組屬性並啟用繫結的物件,可包含多載方法的選擇、引數類型的強制,以及透過反映的成員引動過程。An object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection.
-或--or-
Null 參考 (在 Visual Basic 中為Nothing
),可使用 DefaultBinder。A null reference (Nothing
in Visual Basic), to use the DefaultBinder.
- callConvention
- CallingConventions
物件,其指定一組所要使用的規則,而這些規則是關於引數的順序和配置、如何傳遞傳回值、引數使用哪些暫存器以及如何清除堆疊。The object that specifies the set of rules to use regarding the order and layout of arguments, how the return value is passed, what registers are used for arguments, and how the stack is cleaned up.
- types
- Type[]
Type 物件的陣列,代表所要取得之方法的參數數目、順序和類型。An array of Type objects representing the number, order, and type of the parameters for the method to get.
-或--or-
Type 物件的空陣列 (由 EmptyTypes 欄位提供),可取得不採用參數的方法。An empty array of Type objects (as provided by the EmptyTypes field) to get a method that takes no parameters.
- modifiers
- ParameterModifier[]
ParameterModifier 物件的陣列,代表在 types
陣列中與對應項目關聯的屬性。An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types
array. 只用於透過 COM Interop 進行呼叫以及只處理以傳址方式傳遞的參數。To be only used when calling through COM interop, and only parameters that are passed by reference are handled. 預設的繫結器不會處理這個參數。The default binder does not process this parameter.
傳回
代表方法的物件,其符合指定的泛型參數計數、引數型別、修飾元、繫結限制式及呼叫慣例 (如果有的話);否則為 null
。An object representing the method that matches the specified generic parameter count, argument types, modifiers, binding constraints and calling convention, if found; otherwise, null
.
例外狀況
name
為 null
。name
is null
.
-或--or-
types
為 null
。types
is null
.
-或--or-
types
陣列中的元素之一是 null
。One of the elements in the types
array is null
.
genericParameterCount
為負。genericParameterCount
is negative.
適用於
GetMethod(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
使用指定的繫結條件約束和指定的呼叫慣例,來搜尋指定的方法,而該方法的參數符合指定的引數類型和修飾詞。Searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention.
public:
System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, System::Reflection::CallingConventions callConvention, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);
public:
virtual System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, System::Reflection::CallingConventions callConvention, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);
public System.Reflection.MethodInfo GetMethod (string? name, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, System.Reflection.CallingConventions callConvention, Type[]? types, System.Reflection.ParameterModifier[] modifiers);
public System.Reflection.MethodInfo GetMethod (string name, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, System.Reflection.CallingConventions callConvention, Type[] types, System.Reflection.ParameterModifier[] modifiers);
member this.GetMethod : string * System.Reflection.BindingFlags * System.Reflection.Binder * System.Reflection.CallingConventions * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo
abstract member GetMethod : string * System.Reflection.BindingFlags * System.Reflection.Binder * System.Reflection.CallingConventions * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo
override this.GetMethod : string * System.Reflection.BindingFlags * System.Reflection.Binder * System.Reflection.CallingConventions * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo
Public Function GetMethod (name As String, bindingAttr As BindingFlags, binder As Binder, callConvention As CallingConventions, types As Type(), modifiers As ParameterModifier()) As MethodInfo
參數
- name
- String
字串,包含要取得的方法名稱。The string containing the name of the method to get.
- bindingAttr
- BindingFlags
列舉值的位元組合,用來指定搜尋的執行方式。A bitwise combination of the enumeration values that specify how the search is conducted.
- binder
- Binder
定義一組屬性並啟用繫結的物件,可包含多載方法的選擇、引數類型的強制,以及透過反映的成員引動過程。An object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection.
-或--or-
Null 參考 (在 Visual Basic 中為Nothing
),可使用 DefaultBinder。A null reference (Nothing
in Visual Basic), to use the DefaultBinder.
- callConvention
- CallingConventions
物件,其指定一組所要使用的規則,而這些規則是關於引數的順序和配置、如何傳遞傳回值、引數使用哪些暫存器以及如何清除堆疊。The object that specifies the set of rules to use regarding the order and layout of arguments, how the return value is passed, what registers are used for arguments, and how the stack is cleaned up.
- types
- Type[]
Type 物件的陣列,代表所要取得之方法的參數數目、順序和類型。An array of Type objects representing the number, order, and type of the parameters for the method to get.
-或--or- Type 物件的空陣列 (由 EmptyTypes 欄位提供),可取得不採用參數的方法。An empty array of Type objects (as provided by the EmptyTypes field) to get a method that takes no parameters.
- modifiers
- ParameterModifier[]
ParameterModifier 物件的陣列,代表在 types
陣列中與對應項目關聯的屬性。An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types
array. 只用於透過 COM Interop 進行呼叫以及只處理以傳址方式傳遞的參數。To be only used when calling through COM interop, and only parameters that are passed by reference are handled. 預設的繫結器不會處理這個參數。The default binder does not process this parameter.
傳回
物件,代表符合指定之需求的方法 (如有找到);否則為 null
。An object representing the method that matches the specified requirements, if found; otherwise, null
.
實作
例外狀況
找到一個以上的方法,其具有指定名稱,且符合指定繫結條件約束。More than one method is found with the specified name and matching the specified binding constraints.
name
為 null
。name
is null
.
-或--or-
types
為 null
。types
is null
.
-或--or-
types
的其中一個項目為 null
。One of the elements in types
is null
.
types
是多維的。types
is multidimensional.
-或--or-
modifiers
是多維的。modifiers
is multidimensional.
範例
下列範例會尋找特定的多載 MethodA
,指定系結條件約束、呼叫慣例,以及各種引數類型。The following example finds specific overloads of MethodA
, specifying binding constraints, calling conventions, and a variety of argument types.
注意
此 Visual C# 2005Visual C# 2005 範例需要 /unsafe
編譯器選項。The Visual C# 2005Visual C# 2005 example requires the /unsafe
compiler option.
using namespace System;
using namespace System::Reflection;
public ref class Program
{
public:
// Methods to get:
void MethodA(int i, int j) { }
void MethodA(array<int>^ iarry) { }
void MethodA(double *ip) { }
// Method that takes a managed reference paramter.
void MethodA(int% r) {}
};
int main()
{
MethodInfo^ mInfo;
// Get MethodA(int i, int j)
mInfo = Program::typeid->GetMethod("MethodA",
BindingFlags::Public | BindingFlags::Instance,
nullptr,
CallingConventions::Any,
gcnew array<Type^> {int::typeid, int::typeid},
nullptr);
Console::WriteLine("Found method: {0}", mInfo );
// Get MethodA(array<int>^ iarry)
mInfo = Program::typeid->GetMethod("MethodA",
BindingFlags::Public | BindingFlags::Instance,
nullptr,
CallingConventions::Any,
gcnew array<Type^> {int::typeid->MakeArrayType()},
nullptr);
Console::WriteLine("Found method: {0}", mInfo );
// Get MethodA(double *ip)
mInfo = Program::typeid->GetMethod("MethodA",
BindingFlags::Public | BindingFlags::Instance,
nullptr,
CallingConventions::Any,
gcnew array<Type^> {double::typeid->MakePointerType()},
nullptr);
Console::WriteLine("Found method: {0}", mInfo );
// Get MethodA(int% r)
mInfo = Program::typeid->GetMethod("MethodA",
BindingFlags::Public | BindingFlags::Instance,
nullptr,
CallingConventions::Any,
gcnew array<Type^> {int::typeid->MakeByRefType()},
nullptr);
Console::WriteLine("Found method: {0}", mInfo );
}
using System;
using System.Reflection;
class Program
{
// Methods to get:
public void MethodA(int i, int j) { }
public void MethodA(int[] i) { }
public unsafe void MethodA(int* i) { }
public void MethodA(ref int r) {}
// Method that takes an out parameter:
public void MethodA(int i, out int o) { o = 100;}
static void Main(string[] args)
{
MethodInfo mInfo;
// Get MethodA(int i, int j)
mInfo = typeof(Program).GetMethod("MethodA",
BindingFlags.Public | BindingFlags.Instance,
null,
CallingConventions.Any,
new Type[] { typeof(int), typeof(int) },
null);
Console.WriteLine("Found method: {0}", mInfo);
// Get MethodA(int[] i)
mInfo = typeof(Program).GetMethod("MethodA",
BindingFlags.Public | BindingFlags.Instance,
null,
CallingConventions.Any,
new Type[] { typeof(int[]) },
null);
Console.WriteLine("Found method: {0}", mInfo);
// Get MethodA(int* i)
mInfo = typeof(Program).GetMethod("MethodA",
BindingFlags.Public | BindingFlags.Instance,
null,
CallingConventions.Any,
new Type[] { typeof(int).MakePointerType() },
null);
Console.WriteLine("Found method: {0}", mInfo);
// Get MethodA(ref int r)
mInfo = typeof(Program).GetMethod("MethodA",
BindingFlags.Public | BindingFlags.Instance,
null,
CallingConventions.Any,
new Type[] { typeof(int).MakeByRefType() },
null);
Console.WriteLine("Found method: {0}", mInfo);
// Get MethodA(int i, out int o)
mInfo = typeof(Program).GetMethod("MethodA",
BindingFlags.Public | BindingFlags.Instance,
null,
CallingConventions.Any,
new Type[] { typeof(int), typeof(int).MakeByRefType() },
null);
Console.WriteLine("Found method: {0}", mInfo);
}
}
Imports System.Reflection
Imports System.Runtime.InteropServices
Class Program
' Methods to get:
Public Overloads Sub MethodA(ByVal i As Integer, ByVal l As Long)
End Sub
Public Overloads Sub MethodA(ByVal i() As Integer)
End Sub
Public Overloads Sub MethodA(ByRef r As Integer)
End Sub
' Method that takes an integer and an out parameter. Note that an
' Imports reference is needed to System.Runtime.InteropServices
' for the <OutAttribute>, which can be shortened to <Out>.
Public Overloads Sub MethodA(ByVal i As Integer, <Out()> ByRef o As Integer)
o = 100
End Sub
Public Shared Sub Main(ByVal args() As String)
Dim mInfo As MethodInfo
' Get MethodA(ByVal i As Integer, ByVal l As Long)
mInfo = GetType(Program).GetMethod("MethodA", _
BindingFlags.Public Or BindingFlags.Instance, _
Nothing, _
CallingConventions.Any, _
New Type() {GetType(System.Int32), _
GetType(System.Int64)}, _
Nothing)
Console.WriteLine("Found method: {0}", mInfo)
' Get MethodA(ByVal i() As Integer)
mInfo = GetType(Program).GetMethod("MethodA", _
BindingFlags.Public Or BindingFlags.Instance, _
Nothing, _
CallingConventions.Any, _
New Type() {GetType(System.Int32())}, _
Nothing)
Console.WriteLine("Found method: {0}", mInfo)
' Get MethodA(ByRef r As Integer)
mInfo = GetType(Program).GetMethod("MethodA", _
BindingFlags.Public Or BindingFlags.Instance, _
Nothing, _
CallingConventions.Any, _
New Type() {GetType(System.Int32).MakeByRefType}, _
Nothing)
Console.WriteLine("Found method: {0}", mInfo)
' Get MethodA(ByVal i As Integer, <Out()> ByRef o As Integer)
mInfo = GetType(Program).GetMethod("MethodA", _
BindingFlags.Public Or BindingFlags.Instance, _
Nothing, _
CallingConventions.Any, _
New Type() {GetType(System.Int32), GetType(System.Int32).MakeByRefType}, _
Nothing)
Console.WriteLine("Found method: {0}", mInfo)
End Sub
End Class
備註
雖然預設系結器不會處理 ParameterModifier modifiers
參數) (,但您可以使用抽象 System.Reflection.Binder 類來撰寫執行處理常式的自訂 modifiers
系結器。Although the default binder does not process ParameterModifier (the modifiers
parameter), you can use the abstract System.Reflection.Binder class to write a custom binder that does process modifiers
. ParameterModifier
只有在透過 COM interop 呼叫時才會使用,而且只會處理以傳址方式傳遞的參數。ParameterModifier
is only used when calling through COM interop, and only parameters that are passed by reference are handled.
下表顯示在反映型別時,方法會傳回基類的成員 GetXXX
。The following table shows what members of a base class are returned by the GetXXX
methods when reflecting on a type.
成員類型Member Type | StaticStatic | 非靜態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. |
依名稱和簽章會考慮簽章的所有部分,包括自訂修飾詞、傳回類型、參數類型、個 sentinel 和非受控呼叫慣例。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.
針對反映,屬性和事件會依名稱和簽章來隱藏。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.
自訂屬性不是一般型別系統的一部分。Custom attributes are not part of the common type system.
下列 BindingFlags 篩選旗標可以用來定義要包含在搜尋中的方法:The following BindingFlags filter flags can be used to define which methods to include in the search:
您必須指定或,才能
BindingFlags.Instance
BindingFlags.Static
取得傳回。You must specify eitherBindingFlags.Instance
orBindingFlags.Static
in order to get a return.指定
BindingFlags.Public
要在搜尋中包含公用方法。SpecifyBindingFlags.Public
to include public methods in the search.指定
BindingFlags.NonPublic
要包含非公用方法 (也就是在搜尋中) 私用、內部和受保護的方法。SpecifyBindingFlags.NonPublic
to include nonpublic methods (that is, private, internal, and protected methods) in the search.指定
BindingFlags.FlattenHierarchy
要public
在階層中包含和protected
靜態成員;private
不包含繼承類別中的靜態成員。SpecifyBindingFlags.FlattenHierarchy
to includepublic
andprotected
static members up the hierarchy;private
static members in inherited classes are not included.
您 BindingFlags 可以使用下列修飾詞旗標來變更搜尋的運作方式:The following BindingFlags modifier flags can be used to change how the search works:
BindingFlags.IgnoreCase
忽略的案例name
。BindingFlags.IgnoreCase
to ignore the case ofname
.BindingFlags.DeclaredOnly
只搜尋在上宣告的方法 Type ,而不是單純繼承的方法。BindingFlags.DeclaredOnly
to search only the methods declared on the Type, not methods that were simply inherited.
如需相關資訊,請參閱 System.Reflection.BindingFlags 。See System.Reflection.BindingFlags for more information.
注意
查閱函式和方法時,您不能省略參數。You cannot omit parameters when looking up constructors and methods. 叫用時,您只能省略參數。You can only omit parameters when invoking.
如果目前的 Type 代表結構化泛型型別,這個方法會傳回, MethodInfo 並以適當的型別引數取代型別參數。If the current Type represents a constructed generic type, this method returns the MethodInfo with the type parameters replaced by the appropriate type arguments.
如果目前 Type 表示泛型型別或泛型方法定義中的類型參數,這個方法會搜尋類別條件約束的方法, Object 如果沒有類別條件約束,則會搜尋的方法。If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the methods of the class constraint, or the methods of Object if there is no class constraint.
注意
若為泛型方法,請勿在中包含型別引數 name
。For generic methods, do not include the type arguments in name
. 例如,c # 程式碼 GetMember("MyMethod<int>")
會搜尋文字名稱為 "" 的成員 MyMethod<int>
,而不是使用 MyMethod
類型為的泛型引數之名為的方法 int
。For example, the C# code GetMember("MyMethod<int>")
searches for a member with the text name "MyMethod<int>
", rather than for a method named MyMethod
that has one generic argument of type int
.
另請參閱
- MethodInfo
- String
- BindingFlags
- Binder
- DefaultBinder
- CallingConventions
- ParameterModifier
- GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
- GetMethods()
適用於
GetMethod(String, Int32, BindingFlags, Binder, Type[], ParameterModifier[])
使用指定的繫結限制式來搜尋指定的方法,其參數符合指定的泛型參數計數、引數型別及修飾元。Searches for the specified method whose parameters match the specified generic parameter count, argument types and modifiers, using the specified binding constraints.
public:
System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, int genericParameterCount, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);
public System.Reflection.MethodInfo GetMethod (string? name, int genericParameterCount, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, Type[]? types, System.Reflection.ParameterModifier[] modifiers);
public System.Reflection.MethodInfo GetMethod (string name, int genericParameterCount, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, Type[] types, System.Reflection.ParameterModifier[] modifiers);
member this.GetMethod : string * int * System.Reflection.BindingFlags * System.Reflection.Binder * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo
Public Function GetMethod (name As String, genericParameterCount As Integer, bindingAttr As BindingFlags, binder As Binder, types As Type(), modifiers As ParameterModifier()) As MethodInfo
參數
- name
- String
字串,包含要取得的公用方法名稱。The string containing the name of the public method to get.
- genericParameterCount
- Int32
方法的泛型型別參數數目。The number of generic type parameters of the method.
- bindingAttr
- BindingFlags
列舉值的位元組合,用來指定搜尋的執行方式。A bitwise combination of the enumeration values that specify how the search is conducted.
-或--or-
- binder
- Binder
定義一組屬性並啟用繫結的物件,可包含多載方法的選擇、引數類型的強制,以及透過反映的成員引動過程。An object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection.
-或--or-
Null 參考 (在 Visual Basic 中為Nothing
),可使用 DefaultBinder。A null reference (Nothing
in Visual Basic), to use the DefaultBinder.
- types
- Type[]
Type 物件的陣列,代表所要取得之方法的參數數目、順序和類型。An array of Type objects representing the number, order, and type of the parameters for the method to get.
-或--or-
Type 物件的空陣列 (由 EmptyTypes 欄位提供),可取得不採用參數的方法。An empty array of Type objects (as provided by the EmptyTypes field) to get a method that takes no parameters.
- modifiers
- ParameterModifier[]
ParameterModifier 物件的陣列,代表在 types
陣列中與對應項目關聯的屬性。An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types
array. 只用於透過 COM Interop 進行呼叫以及只處理以傳址方式傳遞的參數。To be only used when calling through COM interop, and only parameters that are passed by reference are handled. 預設的繫結器不會處理這個參數。The default binder does not process this parameter.
傳回
代表方法的物件,其符合指定的泛型參數計數、引數型別、修飾元及繫結限制式 (如果有的話);否則為 null
。An object representing the method that matches the specified generic parameter count, argument types, modifiers and binding constraints, if found; otherwise, null
.
例外狀況
name
為 null
。name
is null
.
-或--or-
types
為 null
。types
is null
.
-或--or-
types
陣列中的元素之一是 null
。One of the elements in the types
array is null
.
genericParameterCount
為負。genericParameterCount
is negative.
適用於
GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])
使用指定的繫結條件約束搜尋指定的方法,而該方法的參數符合指定的引數類型和修飾詞。Searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints.
public:
virtual System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);
public System.Reflection.MethodInfo GetMethod (string? name, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, Type[]? types, System.Reflection.ParameterModifier[] modifiers);
public System.Reflection.MethodInfo GetMethod (string name, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, Type[] types, System.Reflection.ParameterModifier[] modifiers);
abstract member GetMethod : string * System.Reflection.BindingFlags * System.Reflection.Binder * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo
override this.GetMethod : string * System.Reflection.BindingFlags * System.Reflection.Binder * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo
Public Function GetMethod (name As String, bindingAttr As BindingFlags, binder As Binder, types As Type(), modifiers As ParameterModifier()) As MethodInfo
參數
- name
- String
字串,包含要取得的方法名稱。The string containing the name of the method to get.
- bindingAttr
- BindingFlags
列舉值的位元組合,用來指定搜尋的執行方式。A bitwise combination of the enumeration values that specify how the search is conducted.
- binder
- Binder
定義一組屬性並啟用繫結的物件,可包含多載方法的選擇、引數類型的強制,以及透過反映的成員引動過程。An object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection.
-或--or-
Null 參考 (在 Visual Basic 中為Nothing
),可使用 DefaultBinder。A null reference (Nothing
in Visual Basic), to use the DefaultBinder.
- types
- Type[]
Type 物件的陣列,代表所要取得之方法的參數數目、順序和類型。An array of Type objects representing the number, order, and type of the parameters for the method to get.
-或--or- Type 物件的空陣列 (由 EmptyTypes 欄位提供),可取得不採用參數的方法。An empty array of Type objects (as provided by the EmptyTypes field) to get a method that takes no parameters.
- modifiers
- ParameterModifier[]
ParameterModifier 物件的陣列,代表在 types
陣列中與對應項目關聯的屬性。An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types
array. 只用於透過 COM Interop 進行呼叫以及只處理以傳址方式傳遞的參數。To be only used when calling through COM interop, and only parameters that are passed by reference are handled. 預設的繫結器不會處理這個參數。The default binder does not process this parameter.
傳回
物件,代表符合指定之需求的方法 (如有找到);否則為 null
。An object representing the method that matches the specified requirements, if found; otherwise, null
.
實作
例外狀況
找到一個以上的方法,其具有指定名稱,且符合指定繫結條件約束。More than one method is found with the specified name and matching the specified binding constraints.
name
為 null
。name
is null
.
-或--or-
types
為 null
。types
is null
.
-或--or-
types
的其中一個項目為 null
。One of the elements in types
is null
.
types
是多維的。types
is multidimensional.
-或--or-
modifiers
是多維的。modifiers
is multidimensional.
範例
下列範例會尋找的特定 MethodA
多載,並指定系結條件約束和各種引數類型。The following example finds specific overloads of MethodA
, specifying binding constraints and a variety of argument types.
注意
此 Visual C# 2005Visual C# 2005 範例需要 /unsafe
編譯器選項。The Visual C# 2005Visual C# 2005 example requires the /unsafe
compiler option.
using namespace System;
using namespace System::Reflection;
public ref class Program
{
public:
// Methods to get:
void MethodA(int i, int j) { }
void MethodA(array<int>^ iarry) { }
void MethodA(double *ip) { }
// Method that takes a managed reference parameter.
void MethodA(int% r) {}
};
int main()
{
MethodInfo^ mInfo;
// Get MethodA(int i, int j)
mInfo = Program::typeid->GetMethod("MethodA",
static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance),
nullptr,
gcnew array<Type^> {int::typeid, int::typeid},
nullptr);
Console::WriteLine("Found method: {0}", mInfo );
// Get MethodA(array<int>^ iarry)
mInfo = Program::typeid->GetMethod("MethodA",
static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance),
nullptr,
gcnew array<Type^> {int::typeid->MakeArrayType()},
nullptr);
Console::WriteLine("Found method: {0}", mInfo );
// Get MethodA(double *ip)
mInfo = Program::typeid->GetMethod("MethodA",
static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance),
nullptr,
gcnew array<Type^> {double::typeid->MakePointerType()},
nullptr);
Console::WriteLine("Found method: {0}", mInfo );
// Get MethodA(int% r)
mInfo = Program::typeid->GetMethod("MethodA",
static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance),
nullptr,
gcnew array<Type^> {int::typeid->MakeByRefType()},
nullptr);
Console::WriteLine("Found method: {0}", mInfo );
}
using System;
using System.Reflection;
class Program
{
// Methods to get:
public void MethodA(int i, int j) { }
public void MethodA(int[] i) { }
public unsafe void MethodA(int* i) { }
public void MethodA(ref int r) {}
// Method that takes an out parameter.
public void MethodA(int i, out int o) { o = 100; }
static void Main(string[] args)
{
MethodInfo mInfo;
// Get MethodA(int i, int j)
mInfo = typeof(Program).GetMethod("MethodA",
BindingFlags.Public | BindingFlags.Instance,
null,
new Type[] { typeof(int), typeof(int) },
null);
Console.WriteLine("Found method: {0}", mInfo);
// Get MethodA(int[] i)
mInfo = typeof(Program).GetMethod("MethodA",
BindingFlags.Public | BindingFlags.Instance,
null,
new Type[] { typeof(int[]) },
null);
Console.WriteLine("Found method: {0}", mInfo);
// Get MethodA(int* i)
mInfo = typeof(Program).GetMethod("MethodA",
BindingFlags.Public | BindingFlags.Instance,
null,
new Type[] { typeof(int).MakePointerType() },
null);
Console.WriteLine("Found method: {0}", mInfo);
// Get MethodA(ref int r)
mInfo = typeof(Program).GetMethod("MethodA",
BindingFlags.Public | BindingFlags.Instance,
null,
new Type[] { typeof(int).MakeByRefType() },
null);
Console.WriteLine("Found method: {0}", mInfo);
// Get MethodA(int i, out int o)
mInfo = typeof(Program).GetMethod("MethodA",
BindingFlags.Public | BindingFlags.Instance,
null,
new Type[] { typeof(int), typeof(int).MakeByRefType() },
null);
Console.WriteLine("Found method: {0}", mInfo);
}
}
Imports System.Reflection
Imports System.Runtime.InteropServices
Class Program
' Methods to get:
Public Overloads Sub MethodA(ByVal i As Integer, ByVal l As Long)
End Sub
Public Overloads Sub MethodA(ByVal i() As Integer)
End Sub
Public Overloads Sub MethodA(ByRef r As Integer)
End Sub
' Method that takes an out parameter. Note that an Imports
' reference is needed to System.Runtime.InteropServices
' for the <OutAttribute>, which can be shortened to <Out>.
Public Overloads Sub MethodA(ByVal i As Integer, <Out()> ByRef o As Integer)
o = 100
End Sub
Public Shared Sub Main(ByVal args() As String)
Dim mInfo As MethodInfo
' Get MethodA(ByVal i As Integer, ByVal l As Long)
mInfo = GetType(Program).GetMethod("MethodA", _
BindingFlags.Public Or BindingFlags.Instance, _
Nothing, _
New Type() {GetType(System.Int32), _
GetType(System.Int64)}, _
Nothing)
Console.WriteLine("Found method: {0}", mInfo)
' Get MethodA(ByVal i() As Integer)
mInfo = GetType(Program).GetMethod("MethodA", _
BindingFlags.Public Or BindingFlags.Instance, _
Nothing, _
New Type() {GetType(System.Int32())}, _
Nothing)
Console.WriteLine("Found method: {0}", mInfo)
' Get MethodA(ByRef r As Integer)
mInfo = GetType(Program).GetMethod("MethodA", _
BindingFlags.Public Or BindingFlags.Instance, _
Nothing, _
New Type() {GetType(System.Int32).MakeByRefType}, _
Nothing)
Console.WriteLine("Found method: {0}", mInfo)
' Get MethodA(ByVal i As Integer, <Out()> ByRef o As Integer)
mInfo = GetType(Program).GetMethod("MethodA", _
BindingFlags.Public Or BindingFlags.Instance, _
Nothing, _
New Type() {GetType(System.Int32), GetType(System.Int32).MakeByRefType}, _
Nothing)
Console.WriteLine("Found method: {0}", mInfo)
End Sub
End Class
備註
雖然預設系結器不會處理 ParameterModifier modifiers
參數) (,但您可以使用抽象 System.Reflection.Binder 類來撰寫執行處理常式的自訂 modifiers
系結器。Although the default binder does not process ParameterModifier (the modifiers
parameter), you can use the abstract System.Reflection.Binder class to write a custom binder that does process modifiers
. ParameterModifier
只有在透過 COM interop 呼叫時才會使用,而且只會處理以傳址方式傳遞的參數。ParameterModifier
is only used when calling through COM interop, and only parameters that are passed by reference are handled.
下列 BindingFlags 篩選旗標可以用來定義要包含在搜尋中的方法:The following BindingFlags filter flags can be used to define which methods to include in the search:
您必須指定或,才能
BindingFlags.Instance
BindingFlags.Static
取得傳回。You must specify eitherBindingFlags.Instance
orBindingFlags.Static
in order to get a return.指定
BindingFlags.Public
要在搜尋中包含公用方法。SpecifyBindingFlags.Public
to include public methods in the search.指定
BindingFlags.NonPublic
要包含非公用方法 (也就是在搜尋中) 私用、內部和受保護的方法。SpecifyBindingFlags.NonPublic
to include nonpublic methods (that is, private, internal, and protected methods) in the search.指定
BindingFlags.FlattenHierarchy
要public
在階層中包含和protected
靜態成員;private
不包含繼承類別中的靜態成員。SpecifyBindingFlags.FlattenHierarchy
to includepublic
andprotected
static members up the hierarchy;private
static members in inherited classes are not included.
您 BindingFlags 可以使用下列修飾詞旗標來變更搜尋的運作方式:The following BindingFlags modifier flags can be used to change how the search works:
BindingFlags.IgnoreCase
忽略的案例name
。BindingFlags.IgnoreCase
to ignore the case ofname
.BindingFlags.DeclaredOnly
只搜尋在上宣告的方法 Type ,而不是單純繼承的方法。BindingFlags.DeclaredOnly
to search only the methods declared on the Type, not methods that were simply inherited.
如需相關資訊,請參閱 System.Reflection.BindingFlags 。See System.Reflection.BindingFlags for more information.
注意
查閱函式和方法時,您不能省略參數。You cannot omit parameters when looking up constructors and methods. 叫用時,您只能省略參數。You can only omit parameters when invoking.
如果目前的 Type 代表結構化泛型型別,這個方法會傳回, MethodInfo 並以適當的型別引數取代型別參數。If the current Type represents a constructed generic type, this method returns the MethodInfo with the type parameters replaced by the appropriate type arguments.
如果目前 Type 表示泛型型別或泛型方法定義中的類型參數,這個方法會搜尋類別條件約束的方法, Object 如果沒有類別條件約束,則會搜尋的方法。If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the methods of the class constraint, or the methods of Object if there is no class constraint.
注意
若為泛型方法,請勿在中包含型別引數 name
。For generic methods, do not include the type arguments in name
. 例如,c # 程式碼 GetMember("MyMethod<int>")
會搜尋文字名稱為 "" 的成員 MyMethod<int>
,而不是使用 MyMethod
類型為的泛型引數之名為的方法 int
。For example, the C# code GetMember("MyMethod<int>")
searches for a member with the text name "MyMethod<int>
", rather than for a method named MyMethod
that has one generic argument of type int
.
另請參閱
- MethodInfo
- String
- BindingFlags
- Binder
- DefaultBinder
- ParameterModifier
- GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
- GetMethods()
適用於
GetMethod(String, Int32, Type[], ParameterModifier[])
搜尋指定的公用方法,其參數符合指定的泛型參數計數、引數型別及修飾元。Searches for the specified public method whose parameters match the specified generic parameter count, argument types and modifiers.
public:
System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, int genericParameterCount, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);
public System.Reflection.MethodInfo? GetMethod (string name, int genericParameterCount, Type[] types, System.Reflection.ParameterModifier[]? modifiers);
public System.Reflection.MethodInfo GetMethod (string name, int genericParameterCount, Type[] types, System.Reflection.ParameterModifier[] modifiers);
member this.GetMethod : string * int * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo
Public Function GetMethod (name As String, genericParameterCount As Integer, types As Type(), modifiers As ParameterModifier()) As MethodInfo
參數
- name
- String
字串,包含要取得的公用方法名稱。The string containing the name of the public method to get.
- genericParameterCount
- Int32
方法的泛型型別參數數目。The number of generic type parameters of the method.
- types
- Type[]
Type 物件的陣列,代表所要取得之方法的參數數目、順序和類型。An array of Type objects representing the number, order, and type of the parameters for the method to get.
-或--or-
Type 物件的空陣列 (由 EmptyTypes 欄位提供),可取得不採用參數的方法。An empty array of Type objects (as provided by the EmptyTypes field) to get a method that takes no parameters.
- modifiers
- ParameterModifier[]
ParameterModifier 物件的陣列,代表在 types
陣列中與對應項目關聯的屬性。An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types
array. 只用於透過 COM Interop 進行呼叫以及只處理以傳址方式傳遞的參數。To be only used when calling through COM interop, and only parameters that are passed by reference are handled. 預設的繫結器不會處理這個參數。The default binder does not process this parameter.
傳回
代表公用方法的物件,其符合指定的泛型參數計數、引數型別及修飾元 (如果有的話);否則為 null
。An object representing the public method that matches the specified generic parameter count, argument types and modifiers, if found; otherwise, null
.
例外狀況
name
為 null
。name
is null
.
-或--or-
types
為 null
。types
is null
.
-或--or-
types
陣列中的元素之一是 null
。One of the elements in the types
array is null
.
genericParameterCount
為負。genericParameterCount
is negative.
適用於
GetMethod(String, Type[])
搜尋指定的公用方法,其參數符合指定的引數類型。Searches for the specified public method whose parameters match the specified argument types.
public:
System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, cli::array <Type ^> ^ types);
public:
virtual System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, cli::array <Type ^> ^ types);
public System.Reflection.MethodInfo? GetMethod (string name, Type[] types);
public System.Reflection.MethodInfo GetMethod (string name, Type[] types);
member this.GetMethod : string * Type[] -> System.Reflection.MethodInfo
abstract member GetMethod : string * Type[] -> System.Reflection.MethodInfo
override this.GetMethod : string * Type[] -> System.Reflection.MethodInfo
Public Function GetMethod (name As String, types As Type()) As MethodInfo
參數
- name
- String
字串,包含要取得的公用方法名稱。The string containing the name of the public method to get.
- types
- Type[]
Type 物件的陣列,代表所要取得之方法的參數數目、順序和類型。An array of Type objects representing the number, order, and type of the parameters for the method to get.
-或--or- Type 物件的空陣列 (由 EmptyTypes 欄位提供),可取得不採用參數的方法。An empty array of Type objects (as provided by the EmptyTypes field) to get a method that takes no parameters.
傳回
代表其參數符合指定之引數類型的公用方法物件 (如有找到);否則為 null
。An object representing the public method whose parameters match the specified argument types, if found; otherwise, null
.
實作
例外狀況
找到一個以上具有指定名稱及指定參數的方法。More than one method is found with the specified name and specified parameters.
name
為 null
。name
is null
.
-或--or-
types
為 null
。types
is null
.
-或--or-
types
的其中一個項目為 null
。One of the elements in types
is null
.
types
是多維的。types
is multidimensional.
範例
下列範例會尋找的特定 MethodA
多載,並指定各種不同的引數類型。The following example finds specific overloads of MethodA
, specifying a variety of argument types.
注意
此 Visual C# 2005Visual C# 2005 範例需要 /unsafe
編譯器選項。The Visual C# 2005Visual C# 2005 example requires the /unsafe
compiler option.
using namespace System;
using namespace System::Reflection;
public ref class Program
{
public:
// Methods to get:
void MethodA(int i, int j) { }
void MethodA(array<int>^ iarry) { }
void MethodA(double *ip) { }
// Method that takes a managed reference parameter.
void MethodA(int% r) {}
};
int main()
{
MethodInfo^ mInfo;
// Get MethodA(int i, int j)
mInfo = Program::typeid->GetMethod("MethodA", gcnew array<Type^> {int::typeid,int::typeid});
Console::WriteLine("Found method: {0}", mInfo );
// Get MethodA(array<int>^ iarry)
mInfo = Program::typeid->GetMethod("MethodA", gcnew array<Type^> {int::typeid->MakeArrayType()});
Console::WriteLine("Found method: {0}", mInfo );
// Get MethodA(double *ip)
mInfo = Program::typeid->GetMethod("MethodA", gcnew array<Type^> {double::typeid->MakePointerType()});
Console::WriteLine("Found method: {0}", mInfo );
// Get MethodA(int% r)
mInfo = Program::typeid->GetMethod("MethodA", gcnew array<Type^> {int::typeid->MakeByRefType()});
// Display the method information.
Console::WriteLine("Found method: {0}", mInfo );
}
using System;
using System.Reflection;
class Program
{
// Methods to get:
public void MethodA(int i, int j) { }
public void MethodA(int[] i) { }
public unsafe void MethodA(int* i) { }
public void MethodA(ref int r) {}
// Method that takes an out parameter:
public void MethodA(int i, out int o) { o = 100;}
static void Main(string[] args)
{
MethodInfo mInfo;
// Get MethodA(int i, int i)
mInfo = typeof(Program).GetMethod("MethodA",
new Type[] { typeof(int), typeof(int) });
Console.WriteLine("Found method: {0}", mInfo);
// Get MethodA(int[] i)
mInfo = typeof(Program).GetMethod("MethodA",
new Type[] { typeof(int[]) });
Console.WriteLine("Found method: {0}", mInfo);
// Get MethodA(int* i)
mInfo = typeof(Program).GetMethod("MethodA",
new Type[] { typeof(int).MakePointerType() });
Console.WriteLine("Found method: {0}", mInfo);
// Get MethodA(ref int r)
mInfo = typeof(Program).GetMethod("MethodA",
new Type[] { typeof(int).MakeByRefType() });
Console.WriteLine("Found method: {0}", mInfo);
// Get MethodA(int i, out int o)
mInfo = typeof(Program).GetMethod("MethodA",
new Type[] { typeof(int), typeof(int).MakeByRefType() });
Console.WriteLine("Found method: {0}", mInfo);
}
}
Imports System.Reflection
Imports System.Runtime.InteropServices
Class Program
' Methods to get:
Public Overloads Sub MethodA(ByVal i As Integer, ByVal l As Long)
End Sub
Public Overloads Sub MethodA(ByVal i() As Integer)
End Sub
Public Overloads Sub MethodA(ByRef r As Integer)
End Sub
' Method that takes an out parameter. Note that an Imports
' reference is needed to System.Runtime.InteropServices
' for the <OutAttribute>, which can be shortened to <Out>.
Public Overloads Sub MethodA(ByVal i As Integer, <Out()> ByRef o As Integer)
o = 100
End Sub
Public Shared Sub Main(ByVal args() As String)
Dim mInfo As MethodInfo
' Get MethodA(i As Integer i, l As Long)
mInfo = GetType(Program).GetMethod("MethodA", New Type() {GetType(Integer), GetType(Long)})
Console.WriteLine("Found method: {0}", mInfo)
' Get MethodA(i As Integer())
mInfo = GetType(Program).GetMethod("MethodA", New Type() {GetType(Integer())})
Console.WriteLine("Found method: {0}", mInfo)
' Get MethodA(ByRef r As Integer)
mInfo = GetType(Program).GetMethod("MethodA", New Type() {GetType(Integer).MakeByRefType})
Console.WriteLine("Found method: {0}", mInfo)
' Get MethodA(i As Integer, ByRef r As Integer)
mInfo = GetType(Program).GetMethod("MethodA", New Type() {GetType(Integer), _
GetType(Integer).MakeByRefType})
Console.WriteLine("Found method: {0}", mInfo)
End Sub
End Class
下列範例會取出 MethodInfo 物件,這些物件代表 Add
(類別) 的非泛型型別 ArrayList 、 (類別) 的開放式泛型型別, List<T> 以及 (型別的封閉式泛型型別 List(Of String)
。The following example retrieves MethodInfo objects that represent the Add
methods of a non-generic type (the ArrayList class), an open generic type (the List<T> class), and a closed generic type (the List(Of String)
type.
using System;
using System.Collections;
using System.Collections.Generic;
using System.Reflection;
public class Example
{
public static void Main()
{
// Get a Type object that represents a non-generic type.
GetAddMethod(typeof(ArrayList));
var list = new List<String>();
// Get a Type object that represents a constructed generic type.
Type closed = list.GetType();
GetAddMethod(closed);
// Get a Type object that represents an open generic type.
Type open = typeof(List<>);
GetAddMethod(open);
}
private static void GetAddMethod(Type typ)
{
MethodInfo method;
// Determine if this is a generic type.
if (typ.IsGenericType) {
// Is it an open generic type?
if (typ.ContainsGenericParameters)
method = typ.GetMethod("Add", typ.GetGenericArguments());
// Get closed generic type arguments.
else
method = typ.GetMethod("Add", typ.GenericTypeArguments);
}
// This is not a generic type.
else {
method = typ.GetMethod("Add", new Type[] { typeof(Object) } );
}
// Test if an Add method was found.
if (method == null) {
Console.WriteLine("No Add method found.");
return;
}
Type t = method.ReflectedType;
Console.Write("{0}.{1}.{2}(", t.Namespace, t.Name, method.Name);
ParameterInfo[] parms = method.GetParameters();
for (int ctr = 0; ctr < parms.Length; ctr++)
Console.Write("{0}{1}", parms[ctr].ParameterType.Name,
ctr < parms.Length - 1 ? ", " : "");
Console.WriteLine(")");
}
}
// The example displays the following output:
// System.Collections.ArrayList.Add(Object)
// System.Collections.Generic.List`1.Add(String)
// System.Collections.Generic.List`1.Add(T)
Imports System.Collections
Imports System.Collections.Generic
Imports System.Reflection
Module Example
Public Sub Main()
' Get a Type object that represents a non-generic type.
GetAddMethod(GetType(ArrayList))
Dim list As New List(Of String)()
' Get a Type object that represents a constructed generic type.
Dim closed As Type = list.GetType()
GetAddMethod(closed)
' Get a Type object that represents an open generic type.
Dim open As Type = GetType(List(Of))
GetAddMethod(open)
End Sub
Private Sub GetAddMethod(typ As Type)
Dim method As MethodInfo
' Determine if this is a generic type.
If typ.IsGenericType Then
' Is it an open generic type?
If typ.ContainsGenericParameters Then
method = typ.GetMethod("Add", typ.GetGenericArguments())
' Get closed generic type arguments.
Else
method = typ.GetMethod("Add", typ.GenericTypeArguments)
End If
' This is not a generic type.
Else
method = typ.GetMethod("Add", { GetType(Object) } )
End If
' Test if an Add method was found.
If method Is Nothing Then
Console.WriteLine("No Add method found.")
Exit Sub
End If
Dim t As Type = method.ReflectedType
Console.Write("{0}.{1}.{2}(", t.Namespace, t.Name, method.Name)
Dim params() As ParameterInfo = method.GetParameters()
For ctr As Integer = 0 To params.Length - 1
Console.Write("{0}{1}", params(ctr).ParameterType.Name,
If(ctr < params.Length - 1, ", ", ""))
Next
Console.WriteLine(")")
End Sub
End Module
' The example displays the following output:
' System.Collections.ArrayList.Add(Object)
' System.Collections.Generic.List`1.Add(String)
' System.Collections.Generic.List`1.Add(T)
此範例會定義 GetAddMethod
方法,以抓取適當的 MethodInfo 物件。The example defines a GetAddMethod
method that retrieves the appropriate MethodInfo object. 為了提供 types
開放式泛型型別的引數,它會呼叫 Type.GetGenericArguments 方法。To provide the types
argument for an open generic type, it calls the Type.GetGenericArguments method. 為了提供 types
封閉式泛型型別的引數,它會抓取屬性的值 Type.GenericTypeArguments 。To provide the types
argument for a closed generic type, it retrieves the value of the Type.GenericTypeArguments property.
備註
搜尋會區分 name
大小寫。The search for name
is case-sensitive. 搜尋包含公用靜態和公用實例方法。The search includes public static and public instance methods.
注意
查閱函式和方法時,您不能省略參數。You cannot omit parameters when looking up constructors and methods. 叫用時,您只能省略參數。You can only omit parameters when invoking.
如果目前的 Type 代表結構化泛型型別,這個方法會傳回, MethodInfo 並以適當的型別引數取代型別參數。If the current Type represents a constructed generic type, this method returns the MethodInfo with the type parameters replaced by the appropriate type arguments.
如果目前 Type 表示泛型型別或泛型方法定義中的類型參數,這個方法會搜尋類別條件約束的方法, Object 如果沒有類別條件約束,則會搜尋的方法。If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the methods of the class constraint, or the methods of Object if there is no class constraint.
注意
name
參數不能包含型別引數。The name
parameter cannot include type arguments. 例如,c # 程式碼 GetMethod("MyGenericMethod<int>")
會搜尋文字名稱為 "" 的方法 MyGenericMethod<int>
,而不是使用 MyGenericMethod
類型為的泛型引數之名為的方法 int
。For example, the C# code GetMethod("MyGenericMethod<int>")
searches for a method with the text name "MyGenericMethod<int>
", rather than for a method named MyGenericMethod
that has one generic argument of type int
. 請改用 GetMethod("MyGenericMethod")
陣列中的適當參數 types
。Instead, use GetMethod("MyGenericMethod")
with the appropriate parameter in the types
array.
另請參閱
- MethodInfo
- DefaultBinder
- GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
- GetMethods()
適用於
GetMethod(String, Int32, Type[])
搜尋指定的公用方法,其參數符合指定的泛型參數計數和引數型別。Searches for the specified public method whose parameters match the specified generic parameter count and argument types.
public:
System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, int genericParameterCount, cli::array <Type ^> ^ types);
public System.Reflection.MethodInfo? GetMethod (string name, int genericParameterCount, Type[] types);
public System.Reflection.MethodInfo GetMethod (string name, int genericParameterCount, Type[] types);
member this.GetMethod : string * int * Type[] -> System.Reflection.MethodInfo
Public Function GetMethod (name As String, genericParameterCount As Integer, types As Type()) As MethodInfo
參數
- name
- String
字串,包含要取得的公用方法名稱。The string containing the name of the public method to get.
- genericParameterCount
- Int32
方法的泛型型別參數數目。The number of generic type parameters of the method.
- types
- Type[]
Type 物件的陣列,代表所要取得之方法的參數數目、順序和類型。An array of Type objects representing the number, order, and type of the parameters for the method to get.
-或--or-
Type 物件的空陣列 (由 EmptyTypes 欄位提供),可取得不採用參數的方法。An empty array of Type objects (as provided by the EmptyTypes field) to get a method that takes no parameters.
傳回
代表公用方法的物件,其參數符合指定的泛型參數計數和引數型別 (如果有的話);否則為 null
。An object representing the public method whose parameters match the specified generic parameter count and argument types, if found; otherwise, null
.
例外狀況
name
為 null
。name
is null
.
-或--or-
types
為 null
。types
is null
.
-或--or-
types
陣列中的元素之一是 null
。One of the elements in the types
array is null
.
genericParameterCount
為負。genericParameterCount
is negative.
適用於
GetMethod(String, BindingFlags)
使用指定的繫結條件約束搜尋指定的方法。Searches for the specified method, using the specified binding constraints.
public:
virtual System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, System::Reflection::BindingFlags bindingAttr);
public System.Reflection.MethodInfo? GetMethod (string name, System.Reflection.BindingFlags bindingAttr);
public System.Reflection.MethodInfo GetMethod (string name, System.Reflection.BindingFlags bindingAttr);
abstract member GetMethod : string * System.Reflection.BindingFlags -> System.Reflection.MethodInfo
override this.GetMethod : string * System.Reflection.BindingFlags -> System.Reflection.MethodInfo
Public Function GetMethod (name As String, bindingAttr As BindingFlags) As MethodInfo
參數
- name
- String
字串,包含要取得的方法名稱。The string containing the name of the method to get.
- bindingAttr
- BindingFlags
列舉值的位元組合,用來指定搜尋的執行方式。A bitwise combination of the enumeration values that specify how the search is conducted.
傳回
物件,代表符合指定之需求的方法 (如有找到);否則為 null
。An object representing the method that matches the specified requirements, if found; otherwise, null
.
實作
例外狀況
找到一個以上的方法,其具有指定名稱,且符合指定繫結條件約束。More than one method is found with the specified name and matching the specified binding constraints.
name
為 null
。name
is null
.
範例
下列範例會取得符合指定系結旗標的方法。The following example gets the method that matches the specified binding flags.
using namespace System;
using namespace System::Reflection;
public ref class Program
{
public:
// Method to get:
void MethodA() { }
};
int main()
{
// Get MethodA()
MethodInfo^ mInfo = Program::typeid->GetMethod("MethodA",
static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance));
Console::WriteLine("Found method: {0}", mInfo );
}
using System;
using System.Reflection;
class Program
{
// Method to get:
public void MethodA() { }
static void Main(string[] args)
{
// Get MethodA()
MethodInfo mInfo = typeof(Program).GetMethod("MethodA",
BindingFlags.Public | BindingFlags.Instance);
Console.WriteLine("Found method: {0}", mInfo);
}
}
Imports System.Reflection
Class Program
' Method to get:
Public Sub MethodA()
End Sub
Public Shared Sub Main(ByVal args() As String)
' Get MethodA()
Dim mInfo As MethodInfo = GetType(Program).GetMethod("MethodA", _
BindingFlags.Public Or BindingFlags.Instance)
Console.WriteLine("Found method: {0}", mInfo)
End Sub
End Class
備註
下列 BindingFlags 篩選旗標可以用來定義要包含在搜尋中的方法:The following BindingFlags filter flags can be used to define which methods to include in the search:
您必須指定或,才能 BindingFlags.Instance BindingFlags.Static 取得傳回。You must specify either BindingFlags.Instance or BindingFlags.Static in order to get a return.
指定 BindingFlags.Public 要在搜尋中包含公用方法。Specify BindingFlags.Public to include public methods in the search.
指定 BindingFlags.NonPublic 要包含非公用方法 (也就是在搜尋中) 私用、內部和受保護的方法。Specify BindingFlags.NonPublic to include non-public methods (that is, private, internal, and protected methods) in the search.
指定 BindingFlags.FlattenHierarchy 要
public
在階層中包含和protected
靜態成員;private
不包含繼承類別中的靜態成員。Specify BindingFlags.FlattenHierarchy to includepublic
andprotected
static members up the hierarchy;private
static members in inherited classes are not included.
您 BindingFlags 可以使用下列修飾詞旗標來變更搜尋的運作方式:The following BindingFlags modifier flags can be used to change how the search works:
BindingFlags.IgnoreCase 忽略的案例
name
。BindingFlags.IgnoreCase to ignore the case ofname
.BindingFlags.DeclaredOnly 只搜尋在上宣告的方法 Type ,而不是單純繼承的方法。BindingFlags.DeclaredOnly to search only the methods declared on the Type, not methods that were simply inherited.
如需相關資訊,請參閱 System.Reflection.BindingFlags 。See System.Reflection.BindingFlags for more information.
如果方法已多載,而且有多個多載符合引數所指定的條件約束 bindingAttr
,則方法會擲回 AmbiguousMatchException 例外狀況。If a method is overloaded and more than one overload meets the constraints specified by the bindingAttr
argument, the method throws an AmbiguousMatchException exception. 在下列範例中,會擲回例外狀況,因為:In the following example, an exception is thrown because:
此
TestClass
類型具有兩個方法的公用實例多載DisplayValue
:DisplayValue(String)
和DisplayValue(String, Object[])
。TheTestClass
type has two public instance overloads of theDisplayValue
method,DisplayValue(String)
andDisplayValue(String, Object[])
.此
TestClass
類型具有方法的兩個公用實例Equals
多載,其中一個繼承自 Object :Equals(TestClass)
和Equals(Object)
。TheTestClass
type has two public instance overloads of theEquals
method, one of which is inherited from Object:Equals(TestClass)
andEquals(Object)
.
using System;
using System.Reflection;
public class TestClass
{
public void DisplayValue(String s)
{
Console.WriteLine(s);
}
public void DisplayValue(String s, params Object[] values)
{
Console.WriteLine(s, values);
}
public static bool Equals(TestClass t1, TestClass t2)
{
return Object.ReferenceEquals(t1, t2);
}
public bool Equals(TestClass t)
{
return Object.ReferenceEquals(this, t);
}
}
public class Example
{
public static void Main()
{
Type t = typeof(TestClass);
RetrieveMethod(t, "DisplayValue", BindingFlags.Public | BindingFlags.Instance);
RetrieveMethod(t, "Equals", BindingFlags.Public | BindingFlags.Instance);
RetrieveMethod(t, "Equals", BindingFlags.Public | BindingFlags.Instance | BindingFlags.DeclaredOnly);
RetrieveMethod(t, "Equals", BindingFlags.Public | BindingFlags.Static);
}
private static void RetrieveMethod(Type t, String name, BindingFlags flags)
{
try {
MethodInfo m = t.GetMethod(name, flags);
if (m != null) {
Console.Write("{0}.{1}(", t.Name, m.Name);
ParameterInfo[] parms= m.GetParameters();
for (int ctr = 0; ctr <parms.Length; ctr++) {
Console.Write(parms[ctr].ParameterType.Name);
if (ctr < parms.Length - 1)
Console.Write(", ");
}
Console.WriteLine(")");
}
else {
Console.WriteLine("Method not found");
}
}
catch (AmbiguousMatchException) {
Console.WriteLine("The following duplicate matches were found:");
MethodInfo[] methods = t.GetMethods(flags);
foreach (var method in methods) {
if (method.Name != name) continue;
Console.Write(" {0}.{1}(", t.Name, method.Name);
ParameterInfo[] parms = method.GetParameters();
for (int ctr = 0; ctr < parms.Length; ctr++) {
Console.Write(parms[ctr].ParameterType.Name);
if (ctr < parms.Length - 1)
Console.Write(", ");
}
Console.WriteLine(")");
}
}
Console.WriteLine();
}
}
// The example displays the following output:
// The following duplicate matches were found:
// TestClass.DisplayValue(String)
// TestClass.DisplayValue(String, Object[])
//
// The following duplicate matches were found:
// TestClass.Equals(TestClass)
// TestClass.Equals(Object)
//
// TestClass.Equals(TestClass)
//
// TestClass.Equals(TestClass, TestClass)
Imports System.Reflection
Public Class TestClass
Public Sub DisplayValue(s As String)
Console.WriteLine(s)
End Sub
Public Sub DisplayValue(s As String, ParamArray values() As Object)
Console.WriteLine(s, values)
End Sub
Public Overloads Shared Function Equals(t1 As TestClass, t2 As TestClass) As Boolean
Return Object.ReferenceEquals(t1, t2)
End Function
Public Overloads Function Equals(t As TestClass) As Boolean
Return Object.ReferenceEquals(Me, t)
End Function
End Class
Module Example
Public Sub Main()
Dim t As Type = GetType(TestClass)
RetrieveMethod(t, "DisplayValue", BindingFlags.Public Or BindingFlags.Instance)
RetrieveMethod(t, "Equals", BindingFlags.Public Or BindingFlags.Instance)
RetrieveMethod(t, "Equals", BindingFlags.Public Or BindingFlags.Instance Or BindingFlags.DeclaredOnly)
RetrieveMethod(t, "Equals", BindingFlags.Public Or BindingFlags.Static)
End Sub
Public Sub RetrieveMethod(t As Type, name As String, flags As BindingFlags)
Try
Dim m As MethodInfo = t.GetMethod(name, flags)
If m IsNot Nothing Then
Console.Write("{0}.{1}(", t.Name, m.Name)
Dim parms() As ParameterInfo = m.GetParameters()
For ctr As Integer = 0 To parms.Length - 1
Console.Write(parms(ctr).ParameterType.Name)
if ctr < parms.Length - 1 Then
Console.Write(", ")
End If
Next
Console.WriteLine(")")
Else
Console.WriteLine("Method not found")
End If
Catch e As AmbiguousMatchException
Console.WriteLine("The following duplicate matches were found:")
Dim methods() As MethodInfo = t.GetMethods(flags)
For Each method In methods
If method.Name <> name Then Continue For
Console.Write(" {0}.{1}(", t.Name, method.Name)
Dim parms() As ParameterInfo = method.GetParameters()
For ctr As Integer = 0 To parms.Length - 1
Console.Write(parms(ctr).ParameterType.Name)
if ctr < parms.Length - 1 Then
Console.Write(", ")
End If
Next
Console.WriteLine(")")
Next
End Try
Console.WriteLine()
End Sub
End Module
' The example displays the following output:
' The following duplicate matches were found:
' TestClass.DisplayValue(String)
' TestClass.DisplayValue(String, Object[])
'
' The following duplicate matches were found:
' TestClass.Equals(TestClass)
' TestClass.Equals(Object)
'
' TestClass.Equals(TestClass)
'
' TestClass.Equals(TestClass, TestClass)
您可以執行下列其中一項來取出特定的方法:You can do one of the following to retrieve a specific method:
變更系結條件約束。Change the binding constraints. 在上述範例中,嘗試取出型別所宣告的公用實例
Equals
方法,而不是繼承成功的Equals(TestClass)
。In the previous example, attempting to retrieve a public instanceEquals
method that is declared by the type and not inherited successfully retrievesEquals(TestClass)
.呼叫方法的多載 GetMethod ,其中包含
types
定義方法參數類型的參數。Call an overload of the GetMethod method that includes atypes
parameter which defines the types of the method's parameters.呼叫 GetMethods(BindingFlags) 方法,以取得陣列,其中包含屬於具有指定系結屬性之類型的所有方法。Call the GetMethods(BindingFlags) method to retrieve an array containing all of the methods belonging to a type that have the specified binding attributes. 然後,您可以逐一查看,以識別名稱重複的方法
name
。You can then iterate it to identify the duplicate methods namedname
. 上述範例的例外狀況處理常式會說明這種方法 AmbiguousMatchException 。This approach is illustrated in the previous example's handler for the AmbiguousMatchException exception.
如果目前的 Type 代表結構化泛型型別,這個方法會傳回, MethodInfo 並以適當的型別引數取代型別參數。If the current Type represents a constructed generic type, this method returns the MethodInfo with the type parameters replaced by the appropriate type arguments.
如果目前 Type 表示泛型型別或泛型方法定義中的類型參數,這個方法會搜尋類別條件約束的方法, Object 如果沒有類別條件約束,則會搜尋的方法。If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the methods of the class constraint, or the methods of Object if there is no class constraint.
注意
若為泛型方法,請勿在中包含型別引數 name
。For generic methods, do not include the type arguments in name
. 例如,c # 程式碼 GetMember("MyMethod<int>")
會搜尋文字名稱為 "" 的成員 MyMethod<int>
,而不是使用 MyMethod
類型為的泛型引數之名為的方法 int
。For example, the C# code GetMember("MyMethod<int>")
searches for a member with the text name "MyMethod<int>
", rather than for a method named MyMethod
that has one generic argument of type int
.
另請參閱
- MethodInfo
- String
- BindingFlags
- DefaultBinder
- GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
- GetMethods()
適用於
GetMethod(String)
搜尋具有指定名稱的公用方法。Searches for the public method with the specified name.
public:
System::Reflection::MethodInfo ^ GetMethod(System::String ^ name);
public:
virtual System::Reflection::MethodInfo ^ GetMethod(System::String ^ name);
public System.Reflection.MethodInfo? GetMethod (string name);
public System.Reflection.MethodInfo GetMethod (string name);
member this.GetMethod : string -> System.Reflection.MethodInfo
abstract member GetMethod : string -> System.Reflection.MethodInfo
override this.GetMethod : string -> System.Reflection.MethodInfo
Public Function GetMethod (name As String) As MethodInfo
參數
- name
- String
字串,包含要取得的公用方法名稱。The string containing the name of the public method to get.
傳回
物件,代表具有指定之名稱的公用方法 (如有找到);否則為 null
。An object that represents the public method with the specified name, if found; otherwise, null
.
實作
例外狀況
找到一個以上具有指定名稱的方法。More than one method is found with the specified name.
name
為 null
。name
is null
.
範例
下列範例會取得名為的方法 MethodA
。The following example gets a method named MethodA
.
using namespace System;
using namespace System::Reflection;
public ref class Program
{
public:
// Method to get:
void MethodA() { }
};
int main()
{
// Get MethodA()
MethodInfo^ mInfo = Program::typeid->GetMethod("MethodA");
Console::WriteLine("Found method: {0}", mInfo );
}
using System;
using System.Reflection;
class Program
{
// Method to get:
public void MethodA() { }
static void Main(string[] args)
{
// Get MethodA()
MethodInfo mInfo = typeof(Program).GetMethod("MethodA");
Console.WriteLine("Found method: {0}", mInfo);
}
}
Imports System.Reflection
Class Program
' Method to get:
Public Sub MethodA()
End Sub
Public Shared Sub Main(ByVal args() As String)
' Get MethodA()
Dim mInfo As MethodInfo = GetType(Program).GetMethod("MethodA")
Console.WriteLine("Found method: {0}", mInfo)
End Sub
End Class
備註
搜尋會區分 name
大小寫。The search for name
is case-sensitive. 搜尋包含公用靜態和公用實例方法。The search includes public static and public instance methods.
如果方法已多載,而且有多個公用方法,則方法會擲回 GetMethod(String) AmbiguousMatchException 例外狀況。If a method is overloaded and has more than one public method, the GetMethod(String) method throws an AmbiguousMatchException exception. 下列範例會擲回例外狀況,因為方法有一個以上的公用多載 Int32.ToString 。In the following example, an exception is thrown because there is more than one public overload of the Int32.ToString method. 另一方面,因為 Person.ToString
方法會覆寫並因此未多載 Object.ToString ,所以 GetMethod(String) 方法可以取得 MethodInfo 物件。On the other hand, because the Person.ToString
method overrides Object.ToString and therefore is not overloaded, the GetMethod(String) method is able to retrieve the MethodInfo object.
using System;
using System.Reflection;
public class Person
{
public String FirstName;
public String LastName;
public override String ToString()
{
return (FirstName + " " + LastName).Trim();
}
}
public class Example
{
public static void Main()
{
Type t = typeof(Person);
RetrieveMethod(t, "ToString");
t = typeof(Int32);
RetrieveMethod(t, "ToString");
}
private static void RetrieveMethod(Type t, String name)
{
try {
MethodInfo m = t.GetMethod(name);
if (m != null)
Console.WriteLine("{0}.{1}: {2} method", m.ReflectedType.Name,
m.Name, m.IsStatic ? "Static" : "Instance");
else
Console.WriteLine("{0}.ToString method not found", t.Name);
}
catch (AmbiguousMatchException) {
Console.WriteLine("{0}.{1} has multiple public overloads.",
t.Name, name);
}
}
}
// The example displays the following output:
// Person.ToString: Instance method
// Int32.ToString has multiple public overloads.
Imports System.Reflection
Public Class Person
Public FirstName As String
Public LastName As String
Public Overrides Function ToString() As String
Return (FirstName + " " + LastName).Trim()
End Function
End Class
Module Example
Public Sub Main()
Dim t As Type = GetType(Person)
RetrieveMethod(t, "ToString")
t = GetType(Int32)
RetrieveMethod(t, "ToString")
End Sub
Private Sub RetrieveMethod(t As Type, name As String)
Try
Dim m As MethodInfo = t.GetMethod(name)
If m IsNot Nothing Then
Console.WriteLine("{0}.{1}: {2} method", m.ReflectedType.Name,
m.Name, If(m.IsStatic, "Static", "Instance"))
Else
Console.WriteLine("{0}.ToString method not found", t.Name)
End If
Catch e As AmbiguousMatchException
Console.WriteLine("{0}.{1} has multiple public overloads.",
t.Name, name)
End Try
End Sub
End Module
' The example displays the following output:
' Person.ToString: Instance method
' Int32.ToString has multiple public overloads.
您可以執行下列其中一項來取出特定的方法:You can do one of the following to retrieve a specific method:
呼叫 GetMethod(String, BindingFlags) 方法,並指定
bindingAttr
可唯一識別該方法的引數。Call the GetMethod(String, BindingFlags) method and specify abindingAttr
argument that uniquely identifies the method. 例如,如果擲回例外狀況的原因是型別有靜態和實例多載,您就可以指定的bindingAttr
引數 BindingFlags.InstanceOr
BindingFlags.Instance 。For example, if the exception is thrown because a type has a static and an instance overload, you can specify abindingAttr
argument of BindingFlags.InstanceOr
BindingFlags.Instance.呼叫方法的多載 GetMethod ,其中包含
types
定義方法參數類型的參數。Call an overload of the GetMethod method that includes atypes
parameter which defines the types of the method's parameters.呼叫 GetMethods() 方法,以取得包含屬於某個類型之所有公用方法的陣列。Call the GetMethods() method to retrieve an array containing all of the public methods belonging to a type. 然後,您可以逐一查看,以識別名稱重複的方法
name
。You can then iterate it to identify the duplicate methods namedname
.
如果目前的 Type 代表結構化泛型型別,這個方法會傳回, MethodInfo 並以適當的型別引數取代型別參數。If the current Type represents a constructed generic type, this method returns the MethodInfo with the type parameters replaced by the appropriate type arguments.
如果目前 Type 表示泛型型別或泛型方法定義中的類型參數,這個方法會搜尋類別條件約束的方法, Object 如果沒有類別條件約束,則會搜尋的方法。If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the methods of the class constraint, or the methods of Object if there is no class constraint.
注意
若為泛型方法,請勿在中包含型別引數 name
。For generic methods, do not include the type arguments in name
. 例如,c # 程式碼 GetMember("MyMethod<int>")
會搜尋文字名稱為 "" 的成員 MyMethod<int>
,而不是使用 MyMethod
類型為的泛型引數之名為的方法 int
。For example, the C# code GetMember("MyMethod<int>")
searches for a member with the text name "MyMethod<int>
", rather than for a method named MyMethod
that has one generic argument of type int
.
另請參閱
- MethodInfo
- String
- DefaultBinder
- GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
- GetMethods()
適用於
GetMethod(String, Type[], ParameterModifier[])
搜尋指定的公用方法,其參數符合指定的引數類型和修飾詞。Searches for the specified public method whose parameters match the specified argument types and modifiers.
public:
System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);
public:
virtual System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);
public System.Reflection.MethodInfo? GetMethod (string name, Type[] types, System.Reflection.ParameterModifier[]? modifiers);
public System.Reflection.MethodInfo GetMethod (string name, Type[] types, System.Reflection.ParameterModifier[] modifiers);
member this.GetMethod : string * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo
abstract member GetMethod : string * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo
override this.GetMethod : string * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo
Public Function GetMethod (name As String, types As Type(), modifiers As ParameterModifier()) As MethodInfo
參數
- name
- String
字串,包含要取得的公用方法名稱。The string containing the name of the public method to get.
- types
- Type[]
Type 物件的陣列,代表所要取得之方法的參數數目、順序和類型。An array of Type objects representing the number, order, and type of the parameters for the method to get.
-或--or- Type 物件的空陣列 (由 EmptyTypes 欄位提供),可取得不採用參數的方法。An empty array of Type objects (as provided by the EmptyTypes field) to get a method that takes no parameters.
- modifiers
- ParameterModifier[]
ParameterModifier 物件的陣列,代表在 types
陣列中與對應項目關聯的屬性。An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types
array. 只用於透過 COM Interop 進行呼叫以及只處理以傳址方式傳遞的參數。To be only used when calling through COM interop, and only parameters that are passed by reference are handled. 預設的繫結器不會處理這個參數。The default binder does not process this parameter.
傳回
物件,代表符合指定之需求的公用方法 (如有找到),否則為 null
。An object representing the public method that matches the specified requirements, if found; otherwise, null
.
實作
例外狀況
找到一個以上具有指定名稱及指定參數的方法。More than one method is found with the specified name and specified parameters.
name
為 null
。name
is null
.
-或--or-
types
為 null
。types
is null
.
-或--or-
types
的其中一個項目為 null
。One of the elements in types
is null
.
types
是多維的。types
is multidimensional.
-或--or-
modifiers
是多維的。modifiers
is multidimensional.
備註
雖然預設系結器不會處理 ParameterModifier modifiers
參數) (,但您可以使用抽象 System.Reflection.Binder 類來撰寫執行處理常式的自訂 modifiers
系結器。Although the default binder does not process ParameterModifier (the modifiers
parameter), you can use the abstract System.Reflection.Binder class to write a custom binder that does process modifiers
. ParameterModifier
只有在透過 COM interop 呼叫時才會使用,而且只會處理以傳址方式傳遞的參數。ParameterModifier
is only used when calling through COM interop, and only parameters that are passed by reference are handled.
搜尋會區分 name
大小寫。The search for name
is case-sensitive. 搜尋包含公用靜態和公用實例方法。The search includes public static and public instance methods.
注意
查閱函式和方法時,您不能省略參數。You cannot omit parameters when looking up constructors and methods. 叫用時,您只能省略參數。You can only omit parameters when invoking.
如果目前的 Type 代表結構化泛型型別,這個方法會傳回, MethodInfo 並以適當的型別引數取代型別參數。If the current Type represents a constructed generic type, this method returns the MethodInfo with the type parameters replaced by the appropriate type arguments.
如果目前 Type 表示泛型型別或泛型方法定義中的類型參數,這個方法會搜尋類別條件約束的方法, Object 如果沒有類別條件約束,則會搜尋的方法。If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the methods of the class constraint, or the methods of Object if there is no class constraint.
注意
若為泛型方法,請勿在中包含型別引數 name
。For generic methods, do not include the type arguments in name
. 例如,c # 程式碼 GetMethod("MyMethod<int>")
會搜尋文字名稱為 "" 的成員 MyMethod<int>
,而不是使用 MyMethod
類型為的泛型引數之名為的方法 int
。For example, the C# code GetMethod("MyMethod<int>")
searches for a member with the text name "MyMethod<int>
", rather than for a method named MyMethod
that has one generic argument of type int
. 請改用 GetMethod("MyMethod")
陣列中的適當參數 types
。Instead, use GetMethod("MyMethod")
with the appropriate parameter in the types
array.
另請參閱
- MethodInfo
- String
- DefaultBinder
- ParameterModifier
- GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
- GetMethods()