Type.GetMethod 方法

定義

命名空間:

System

組件:

System.Runtime.dll

取得目前 Type的特定方法。

多載

GetMethod(String, Int32, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])	使用指定的系結條件約束和指定的呼叫慣例，搜尋指定的方法，其參數符合指定的泛型參數計數、自變數類型和修飾詞。
GetMethod(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])	使用指定的系結條件約束和指定的呼叫慣例，搜尋指定的方法，其參數符合指定的自變數類型和修飾詞。
GetMethod(String, Int32, BindingFlags, Binder, Type[], ParameterModifier[])	使用指定的系結條件約束，搜尋指定的方法，其參數符合指定的泛型參數計數、自變數類型和修飾詞。
GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])	使用指定的系結條件約束，搜尋指定的方法，其參數符合指定的自變數類型和修飾詞。
GetMethod(String, Int32, Type[], ParameterModifier[])	搜尋指定的公用方法，其參數符合指定的泛型參數計數、自變數類型和修飾詞。
GetMethod(String, BindingFlags)	使用指定的系結條件約束搜尋指定的方法。
GetMethod(String, BindingFlags, Type[])	使用指定的系結條件約束，搜尋指定的方法，其參數符合指定的自變數類型。
GetMethod(String, Int32, Type[])	搜尋指定的公用方法，其參數符合指定的泛型參數計數和自變數類型。
GetMethod(String, Type[])	搜尋指定的公用方法，其參數符合指定的自變數類型。
GetMethod(String)	搜尋具有指定名稱的公用方法。
GetMethod(String, Type[], ParameterModifier[])	搜尋指定的公用方法，其參數符合指定的自變數類型和修飾詞。

GetMethod(String, Int32, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])

來源:

Type.cs

使用指定的系結條件約束和指定的呼叫慣例，搜尋指定的方法，其參數符合指定的泛型參數計數、自變數類型和修飾詞。

C#

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);

參數

name

String

包含要取得之公用方法名稱的字串。

genericParameterCount

Int32

方法的泛型型別參數數目。

bindingAttr

BindingFlags

列舉值的位元組合，指定搜尋的執行方式。

-或-

Default 傳回 null。

binder

Binder

對象，定義一組屬性並啟用系結，這可以涉及選取多載方法、強制自變數類型，以及透過反映調用成員。

-或-

Null 參考 （在 Visual Basic 中Nothing），以使用 DefaultBinder。

callConvention

CallingConventions

物件，指定要針對自變數的順序和配置使用的規則集、傳遞傳回值的方式、用於自變數的緩存器，以及如何清除堆疊。

types

Type[]

Type 對象的陣列，表示要取得之方法的參數數目、順序和類型。

-或-

Type 物件的空陣列（如 EmptyTypes 欄位提供），以取得不採用任何參數的方法。

modifiers

ParameterModifier[]

ParameterModifier 物件的陣列，表示與 types 陣列中對應專案相關聯的屬性。 只有在透過 COM Interop 呼叫時才會使用，而且只會處理以傳址方式傳遞的參數。 默認係結器不會處理此參數。

傳回

MethodInfo

物件，表示符合指定泛型參數計數、自變數類型、修飾詞、系結條件約束和呼叫慣例的方法，如果找到則為 ;否則，null。

例外狀況

ArgumentNullException

name null。

-或-

types null。

-或-

types 陣列中的其中一個項目是 null。

ArgumentException

genericParameterCount 為負數。

GetMethod(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])

來源:

Type.cs

使用指定的系結條件約束和指定的呼叫慣例，搜尋指定的方法，其參數符合指定的自變數類型和修飾詞。

C#

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);

參數

name

String

包含要取得之方法名稱的字串。

bindingAttr

BindingFlags

列舉值的位元組合，指定搜尋的執行方式。

-或-

Default 傳回 null。

binder

Binder

對象，定義一組屬性並啟用系結，這可以涉及選取多載方法、強制自變數類型，以及透過反映調用成員。

-或-

Null 參考 （在 Visual Basic 中Nothing），以使用 DefaultBinder。

callConvention

CallingConventions

物件，指定要針對自變數的順序和配置使用的規則集、傳遞傳回值的方式、用於自變數的緩存器，以及如何清除堆疊。

types

Type[]

Type 對象的陣列，表示要取得之方法的參數數目、順序和類型。

-或-

Type 物件的空陣列（如 EmptyTypes 欄位提供），以取得不採用任何參數的方法。

modifiers

ParameterModifier[]

ParameterModifier 物件的陣列，表示與 types 陣列中對應專案相關聯的屬性。 只有在透過 COM Interop 呼叫時才會使用，而且只會處理以傳址方式傳遞的參數。 默認係結器不會處理此參數。

傳回

MethodInfo

物件，表示符合指定需求的方法，如果找到則為 ;否則，null。

例外狀況

AmbiguousMatchException

找到一個以上的方法具有指定的名稱，並符合指定的系結條件約束。

ArgumentNullException

name null。

-或-

types null。

-或-

types 中的其中一個項目是 null。

ArgumentException

types 是多維度。

-或-

modifiers 是多維度。

範例

下列範例會尋找 MethodA的特定多載、指定系結條件約束、呼叫慣例，以及各種自變數類型。

備註

Visual C# 2005 範例需要 /unsafe 編譯程序選項。

C#

using System;
using System.Reflection;

class Program3
{
    // 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);
  }
}

備註

雖然預設系結器不會處理 ParameterModifier （modifiers 參數），但您可以使用抽象 System.Reflection.Binder 類別來撰寫會處理 modifiers的自定義系結器。 只有在透過 COM Interop 呼叫時，才會使用 ParameterModifier，而且只會處理以傳址方式傳遞的參數。

下表顯示基類的成員在反映型別時，GetXXX 方法會傳回哪些成員。

成員類型	靜態的	非靜態
構造 函數	不	不
田	不	是的。 欄位一律為依名稱和簽章隱藏。
事件	不適用	常見的類型系統規則是繼承與實作 屬性的方法相同。 反映會將屬性視為 hide-by-name-and-signature。 請參閱下面的附註 2。
方法	不	是的。 方法（虛擬和非虛擬）可以是依名稱隱藏或依名稱和簽章隱藏。
巢狀類型	不	不
財產	不適用	常見的類型系統規則是繼承與實作 屬性的方法相同。 反映會將屬性視為 hide-by-name-and-signature。 請參閱下面的附註 2。

1. 依名稱和簽章隱藏會考慮簽章的所有部分，包括自定義修飾詞、傳回類型、參數類型、sentinels 和 Unmanaged 呼叫慣例。 這是二進位比較。

2. 針對反映，屬性和事件是依名稱與簽章隱藏。 如果您的屬性在基類中同時具有 get 和 set 存取子，但衍生類別只有 get 存取子，衍生類別屬性會隱藏基類屬性，而且您將無法存取基類上的 setter。

3. 自訂屬性不是一般類型系統的一部分。

下列 BindingFlags 篩選旗標可用來定義要包含在搜尋中的方法：

• 您必須指定 BindingFlags.Instance 或 BindingFlags.Static，才能取得傳回。

• 指定 BindingFlags.Public 以在搜尋中包含公用方法。

• 指定 BindingFlags.NonPublic，以在搜尋中包含非公用方法（也就是私用、內部和受保護的方法）。

• 指定 BindingFlags.FlattenHierarchy 以包含階層中的 public 和 protected 靜態成員;private 繼承類別中的靜態成員不包含在內。

下列 BindingFlags 修飾詞旗標可用來變更搜尋的運作方式：

• BindingFlags.IgnoreCase 忽略 name大小寫。

• BindingFlags.DeclaredOnly 只搜尋在 Type上宣告的方法，而不是只繼承的方法。

如需詳細資訊，請參閱 System.Reflection.BindingFlags。

備註

查閱建構函式和方法時，您無法省略參數。 您只能在叫用時省略參數。

如果目前的 Type 代表建構的泛型型別，這個方法會傳回 MethodInfo，並將類型參數取代為適當的型別自變數。

如果目前的 Type 代表泛型型別或泛型方法定義中的型別參數，這個方法會搜尋類別條件約束的方法，如果沒有類別條件約束，則為 Object 的方法。

備註

針對泛型方法，請勿在 name中包含類型自變數。 例如，C# 程式代碼 GetMember("MyMethod<int>") 搜尋具有文字名稱 「MyMethod<int>」 的成員，而不是 int類型為一個泛型自變數的方法 MyMethod。

另請參閱

• MethodInfo
• String
• BindingFlags
• Binder
• DefaultBinder
• CallingConventions
• ParameterModifier
• GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
• GetMethods()

GetMethod(String, Int32, BindingFlags, Binder, Type[], ParameterModifier[])

來源:

Type.cs

使用指定的系結條件約束，搜尋指定的方法，其參數符合指定的泛型參數計數、自變數類型和修飾詞。

C#

public System.Reflection.MethodInfo? GetMethod (string name, int genericParameterCount, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, Type[] types, System.Reflection.ParameterModifier[]? modifiers);

參數

name

String

包含要取得之公用方法名稱的字串。

genericParameterCount

Int32

方法的泛型型別參數數目。

bindingAttr

BindingFlags

列舉值的位元組合，指定搜尋的執行方式。

-或-

Default 傳回 null。

binder

Binder

對象，定義一組屬性並啟用系結，這可以涉及選取多載方法、強制自變數類型，以及透過反映調用成員。

-或-

Null 參考 （在 Visual Basic 中Nothing），以使用 DefaultBinder。

types

Type[]

Type 對象的陣列，表示要取得之方法的參數數目、順序和類型。

-或-

Type 物件的空陣列（如 EmptyTypes 欄位提供），以取得不採用任何參數的方法。

modifiers

ParameterModifier[]

ParameterModifier 物件的陣列，表示與 types 陣列中對應專案相關聯的屬性。 只有在透過 COM Interop 呼叫時才會使用，而且只會處理以傳址方式傳遞的參數。 默認係結器不會處理此參數。

傳回

MethodInfo

物件，代表符合指定泛型參數計數、自變數類型、修飾詞和系結條件約束的方法，如果找到則為 ;否則，null。

例外狀況

ArgumentNullException

name null。

-或-

types null。

-或-

types 陣列中的其中一個項目是 null。

ArgumentException

genericParameterCount 為負數。

GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])

來源:

Type.cs

使用指定的系結條件約束，搜尋指定的方法，其參數符合指定的自變數類型和修飾詞。

C#

public System.Reflection.MethodInfo? GetMethod (string name, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, Type[] types, System.Reflection.ParameterModifier[]? modifiers);

參數

name

String

包含要取得之方法名稱的字串。

bindingAttr

BindingFlags

列舉值的位元組合，指定搜尋的執行方式。

-或-

Default 傳回 null。

binder

Binder

對象，定義一組屬性並啟用系結，這可以涉及選取多載方法、強制自變數類型，以及透過反映調用成員。

-或-

Null 參考 （在 Visual Basic 中Nothing），以使用 DefaultBinder。

types

Type[]

Type 對象的陣列，表示要取得之方法的參數數目、順序和類型。

-或-

Type 物件的空陣列（如 EmptyTypes 欄位提供），以取得不採用任何參數的方法。

modifiers

ParameterModifier[]

ParameterModifier 物件的陣列，表示與 types 陣列中對應專案相關聯的屬性。 只有在透過 COM Interop 呼叫時才會使用，而且只會處理以傳址方式傳遞的參數。 默認係結器不會處理此參數。

傳回

MethodInfo

物件，表示符合指定需求的方法，如果找到則為 ;否則，null。

實作

GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])

例外狀況

AmbiguousMatchException

找到一個以上的方法具有指定的名稱，並符合指定的系結條件約束。

ArgumentNullException

name null。

-或-

types null。

-或-

types 中的其中一個項目是 null。

ArgumentException

types 是多維度。

-或-

modifiers 是多維度。

範例

下列範例會尋找 MethodA的特定多載，並指定系結條件約束和各種自變數類型。

備註

Visual C# 2005 範例需要 /unsafe 編譯程序選項。

C#

using System;
using System.Reflection;

class Program5
{
    // 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);
  }
}

備註

雖然預設系結器不會處理 ParameterModifier （modifiers 參數），但您可以使用抽象 System.Reflection.Binder 類別來撰寫會處理 modifiers的自定義系結器。 只有在透過 COM Interop 呼叫時，才會使用 ParameterModifier，而且只會處理以傳址方式傳遞的參數。

下列 BindingFlags 篩選旗標可用來定義要包含在搜尋中的方法：

• 您必須指定 BindingFlags.Instance 或 BindingFlags.Static，才能取得傳回。

• 指定 BindingFlags.Public 以在搜尋中包含公用方法。

• 指定 BindingFlags.NonPublic，以在搜尋中包含非公用方法（也就是私用、內部和受保護的方法）。

• 指定 BindingFlags.FlattenHierarchy 以包含階層中的 public 和 protected 靜態成員;private 繼承類別中的靜態成員不包含在內。

下列 BindingFlags 修飾詞旗標可用來變更搜尋的運作方式：

• BindingFlags.IgnoreCase 忽略 name大小寫。

• BindingFlags.DeclaredOnly 只搜尋在 Type上宣告的方法，而不是只繼承的方法。

如需詳細資訊，請參閱 System.Reflection.BindingFlags。

備註

查閱建構函式和方法時，您無法省略參數。 您只能在叫用時省略參數。

如果目前的 Type 代表建構的泛型型別，這個方法會傳回 MethodInfo，並將類型參數取代為適當的型別自變數。

如果目前的 Type 代表泛型型別或泛型方法定義中的型別參數，這個方法會搜尋類別條件約束的方法，如果沒有類別條件約束，則為 Object 的方法。

備註

針對泛型方法，請勿在 name中包含類型自變數。 例如，C# 程式代碼 GetMember("MyMethod<int>") 搜尋具有文字名稱 「MyMethod<int>」 的成員，而不是 int類型為一個泛型自變數的方法 MyMethod。

另請參閱

• MethodInfo
• String
• BindingFlags
• Binder
• DefaultBinder
• ParameterModifier
• GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
• GetMethods()

GetMethod(String, Int32, Type[], ParameterModifier[])

來源:

Type.cs

搜尋指定的公用方法，其參數符合指定的泛型參數計數、自變數類型和修飾詞。

C#

public System.Reflection.MethodInfo? GetMethod (string name, int genericParameterCount, Type[] types, System.Reflection.ParameterModifier[]? modifiers);

參數

name

String

包含要取得之公用方法名稱的字串。

genericParameterCount

Int32

方法的泛型型別參數數目。

types

Type[]

Type 對象的陣列，表示要取得之方法的參數數目、順序和類型。

-或-

Type 物件的空陣列（如 EmptyTypes 欄位提供），以取得不採用任何參數的方法。

modifiers

ParameterModifier[]

ParameterModifier 物件的陣列，表示與 types 陣列中對應專案相關聯的屬性。 只有在透過 COM Interop 呼叫時才會使用，而且只會處理以傳址方式傳遞的參數。 默認係結器不會處理此參數。

傳回

MethodInfo

物件，表示符合指定泛型參數計數、自變數類型和修飾詞的公用方法，如果找到則為 ;否則，null。

例外狀況

ArgumentNullException

name null。

-或-

types null。

-或-

types 陣列中的其中一個項目是 null。

ArgumentException

genericParameterCount 為負數。

GetMethod(String, BindingFlags)

來源:

Type.cs

使用指定的系結條件約束搜尋指定的方法。

C#

public System.Reflection.MethodInfo? GetMethod (string name, System.Reflection.BindingFlags bindingAttr);

參數

name

String

包含要取得之方法名稱的字串。

bindingAttr

BindingFlags

列舉值的位元組合，指定搜尋的執行方式。

-或-

Default 傳回 null。

傳回

MethodInfo

物件，表示符合指定需求的方法，如果找到則為 ;否則，null。

實作

GetMethod(String, BindingFlags)

例外狀況

AmbiguousMatchException

找到一個以上的方法具有指定的名稱，並符合指定的系結條件約束。

ArgumentNullException

name null。

範例

下列範例會取得符合指定系結旗標的方法。

C#

using System;
using System.Reflection;

class Program2
{
    // 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);
    }
}

備註

下列 BindingFlags 篩選旗標可用來定義要包含在搜尋中的方法：

• 您必須指定 BindingFlags.Instance 或 BindingFlags.Static，才能取得傳回。

• 指定 BindingFlags.Public 以在搜尋中包含公用方法。

• 指定 BindingFlags.NonPublic 在搜尋中包含非公用方法（也就是私用、內部和受保護的方法）。

• 指定 BindingFlags.FlattenHierarchy 以包含階層中的 public 和 protected 靜態成員;private 繼承類別中的靜態成員不包含在內。

下列 BindingFlags 修飾詞旗標可用來變更搜尋的運作方式：

• BindingFlags.IgnoreCase 忽略 name大小寫。

• BindingFlags.DeclaredOnly 只搜尋在 Type上宣告的方法，而不是只繼承的方法。

如需詳細資訊，請參閱 System.Reflection.BindingFlags。

如果方法多載且多個多載符合 bindingAttr 自變數所指定的條件約束，此方法會擲回 AmbiguousMatchException 例外狀況。 在下列範例中，會擲回例外狀況，因為：

• TestClass 類型具有兩個公用實例多載的 DisplayValue 方法，DisplayValue(String) 和 DisplayValue(String, Object[])。

• TestClass 類型具有兩個公用實例多載的 Equals 方法，其中一個繼承自 Object：Equals(TestClass) 和 Equals(Object)。

C#

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 Example1
{
    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)

您可以執行下列其中一項來擷取特定方法：

• 變更系結條件約束。 在上一個範例中，嘗試擷取類型所宣告的公用實例 Equals 方法，且未成功擷取 Equals(TestClass)。

• 呼叫 GetMethod 方法的多載，其中包含定義方法參數類型的 types 參數。

• 呼叫 GetMethods(BindingFlags) 方法來擷取陣列，其中包含屬於具有指定系結屬性之型別的所有方法。 然後，您可以反覆運算它，以識別名為 name的重複方法。 這個方法說明於上一個範例的處理程式中，用於 AmbiguousMatchException 例外狀況。

如果目前的 Type 代表建構的泛型型別，這個方法會傳回 MethodInfo，並將類型參數取代為適當的型別自變數。

如果目前的 Type 代表泛型型別或泛型方法定義中的型別參數，這個方法會搜尋類別條件約束的方法，如果沒有類別條件約束，則為 Object 的方法。

備註

針對泛型方法，請勿在 name中包含類型自變數。 例如，C# 程式代碼 GetMember("MyMethod<int>") 搜尋具有文字名稱 「MyMethod<int>」 的成員，而不是 int類型為一個泛型自變數的方法 MyMethod。

另請參閱

• MethodInfo
• String
• BindingFlags
• DefaultBinder
• GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
• GetMethods()

GetMethod(String, BindingFlags, Type[])

來源:

Type.cs

使用指定的系結條件約束，搜尋指定的方法，其參數符合指定的自變數類型。

C#

public System.Reflection.MethodInfo? GetMethod (string name, System.Reflection.BindingFlags bindingAttr, Type[] types);

參數

name

String

包含要取得之方法名稱的字串。

bindingAttr

BindingFlags

列舉值的位元組合，指定搜尋的執行方式。 -或- 預設會傳回 null。

types

Type[]

Type 對象的陣列，表示要取得之方法的參數數目、順序和類型。 -或- Type 物件的空陣列（如 EmptyTypes 欄位所提供），以取得不採用任何參數的方法。

傳回

MethodInfo

物件，表示符合指定需求的方法，如果找到則為 ;否則，null。

GetMethod(String, Int32, Type[])

來源:

Type.cs

搜尋指定的公用方法，其參數符合指定的泛型參數計數和自變數類型。

C#

public System.Reflection.MethodInfo? GetMethod (string name, int genericParameterCount, Type[] types);

參數

name

String

包含要取得之公用方法名稱的字串。

genericParameterCount

Int32

方法的泛型型別參數數目。

types

Type[]

Type 對象的陣列，表示要取得之方法的參數數目、順序和類型。

-或-

Type 物件的空陣列（如 EmptyTypes 欄位提供），以取得不採用任何參數的方法。

傳回

MethodInfo

物件，代表公用方法，其參數符合指定的泛型參數計數和自變數類型，如果找到則為 ;否則，null。

例外狀況

ArgumentNullException

name null。

-或-

types null。

-或-

types 陣列中的其中一個項目是 null。

ArgumentException

genericParameterCount 為負數。

GetMethod(String, Type[])

來源:

Type.cs

搜尋指定的公用方法，其參數符合指定的自變數類型。

C#

public System.Reflection.MethodInfo? GetMethod (string name, Type[] types);

參數

name

String

包含要取得之公用方法名稱的字串。

types

Type[]

Type 對象的陣列，表示要取得之方法的參數數目、順序和類型。

-或-

Type 物件的空陣列（如 EmptyTypes 欄位提供），以取得不採用任何參數的方法。

傳回

MethodInfo

物件，代表公用方法，如果找到參數符合指定的自變數類型，則為 ;否則，null。

例外狀況

AmbiguousMatchException

使用指定的名稱和指定的參數找到多個方法。

ArgumentNullException

name null。

-或-

types null。

-或-

types 中的其中一個項目是 null。

ArgumentException

types 是多維度。

範例

下列範例會尋找 MethodA的特定多載，並指定各種自變數類型。

備註

Visual C# 2005 範例需要 /unsafe 編譯程序選項。

C#

using System;
using System.Reflection;

class Program4
{
    // 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);
  }
}

下列範例會擷取 MethodInfo 對象，這些物件代表非泛型類型的 Add 方法（ArrayList 類別）、開放式泛型型別（List<T> 類別），以及封閉式泛型型別（List(Of String) 型別。

C#

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)

此範例會定義擷取適當 MethodInfo 物件的 GetAddMethod 方法。 若要提供開啟泛型類型的 types 自變數，它會呼叫 Type.GetGenericArguments 方法。 若要為封閉式泛型型別提供 types 自變數，它會擷取 Type.GenericTypeArguments 屬性的值。

備註

搜尋 name 會區分大小寫。 搜尋包含公用靜態和公用實例方法。

備註

查閱建構函式和方法時，您無法省略參數。 您只能在叫用時省略參數。

如果目前的 Type 代表建構的泛型型別，這個方法會傳回 MethodInfo，並將類型參數取代為適當的型別自變數。

如果目前的 Type 代表泛型型別或泛型方法定義中的型別參數，這個方法會搜尋類別條件約束的方法，如果沒有類別條件約束，則為 Object 的方法。

備註

name 參數不能包含類型自變數。 例如，C# 程式代碼 GetMethod("MyGenericMethod<int>") 搜尋具有文字名稱 「MyGenericMethod<int>」 的方法，而不是 int類型為一個泛型自變數的方法 MyGenericMethod。 請改用 GetMethod("MyGenericMethod") 搭配 types 陣列中的適當參數。

另請參閱

• MethodInfo
• DefaultBinder
• GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
• GetMethods()

GetMethod(String)

來源:

Type.cs

搜尋具有指定名稱的公用方法。

C#

public System.Reflection.MethodInfo? GetMethod (string name);

參數

name

String

包含要取得之公用方法名稱的字串。

傳回

MethodInfo

物件，如果找到，表示具有指定名稱的公用方法;否則，null。

例外狀況

AmbiguousMatchException

找到多個具有指定名稱的方法。

ArgumentNullException

name null。

範例

下列範例會取得名為 MethodA的方法。

C#

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);
    }
}

備註

搜尋 name 會區分大小寫。 搜尋包含公用靜態和公用實例方法。

如果方法多載且具有多個公用方法，則 GetMethod(String) 方法會擲回 AmbiguousMatchException 例外狀況。 在下列範例中，會擲回例外狀況，因為 Int32.ToString 方法有多個公用多載。 另一方面，因為 Person.ToString 方法會覆寫 Object.ToString，因此不會多載，所以 GetMethod(String) 方法能夠擷取 MethodInfo 物件。

C#

using System;
using System.Reflection;

public class Person
{
    public String FirstName;
    public String LastName;

    public override String ToString()
    {
        return (FirstName + " " + LastName).Trim();
    }
}

public class Example2
{
    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.

您可以執行下列其中一項來擷取特定方法：

• 呼叫 GetMethod(String, BindingFlags) 方法，並指定可唯一識別方法的 bindingAttr 自變數。 例如，如果因為類型具有靜態和實例多載而擲回例外狀況，您可以指定 BindingFlags.InstanceOrBindingFlags.Instance的 bindingAttr 自變數。

• 呼叫 GetMethod 方法的多載，其中包含定義方法參數類型的 types 參數。

• 呼叫 GetMethods() 方法來擷取數位列，其中包含屬於型別的所有公用方法。 然後，您可以反覆運算它，以識別名為 name的重複方法。

如果目前的 Type 代表建構的泛型型別，這個方法會傳回 MethodInfo，並將類型參數取代為適當的型別自變數。

如果目前的 Type 代表泛型型別或泛型方法定義中的型別參數，這個方法會搜尋類別條件約束的方法，如果沒有類別條件約束，則為 Object 的方法。

備註

針對泛型方法，請勿在 name中包含類型自變數。 例如，C# 程式代碼 GetMember("MyMethod<int>") 搜尋具有文字名稱 「MyMethod<int>」 的成員，而不是 int類型為一個泛型自變數的方法 MyMethod。

另請參閱

• MethodInfo
• String
• DefaultBinder
• GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
• GetMethods()

GetMethod(String, Type[], ParameterModifier[])

來源:

Type.cs

搜尋指定的公用方法，其參數符合指定的自變數類型和修飾詞。

C#

public System.Reflection.MethodInfo? GetMethod (string name, Type[] types, System.Reflection.ParameterModifier[]? modifiers);

參數

name

String

包含要取得之公用方法名稱的字串。

types

Type[]

Type 對象的陣列，表示要取得之方法的參數數目、順序和類型。

-或-

Type 物件的空陣列（如 EmptyTypes 欄位提供），以取得不採用任何參數的方法。

modifiers

ParameterModifier[]

ParameterModifier 物件的陣列，表示與 types 陣列中對應專案相關聯的屬性。 只有在透過 COM Interop 呼叫時才會使用，而且只會處理以傳址方式傳遞的參數。 默認係結器不會處理此參數。

傳回

MethodInfo

物件，表示符合指定需求的公用方法，如果找到則為 ;否則，null。

例外狀況

AmbiguousMatchException

使用指定的名稱和指定的參數找到多個方法。

ArgumentNullException

name null。

-或-

types null。

-或-

types 中的其中一個項目是 null。

ArgumentException

types 是多維度。

-或-

modifiers 是多維度。

備註

雖然預設系結器不會處理 ParameterModifier （modifiers 參數），但您可以使用抽象 System.Reflection.Binder 類別來撰寫會處理 modifiers的自定義系結器。 只有在透過 COM Interop 呼叫時，才會使用 ParameterModifier，而且只會處理以傳址方式傳遞的參數。

搜尋 name 會區分大小寫。 搜尋包含公用靜態和公用實例方法。

備註

查閱建構函式和方法時，您無法省略參數。 您只能在叫用時省略參數。

如果目前的 Type 代表建構的泛型型別，這個方法會傳回 MethodInfo，並將類型參數取代為適當的型別自變數。

如果目前的 Type 代表泛型型別或泛型方法定義中的型別參數，這個方法會搜尋類別條件約束的方法，如果沒有類別條件約束，則為 Object 的方法。

備註

針對泛型方法，請勿在 name中包含類型自變數。 例如，C# 程式代碼 GetMethod("MyMethod<int>") 搜尋具有文字名稱 「MyMethod<int>」 的成員，而不是 int類型為一個泛型自變數的方法 MyMethod。 請改用 GetMethod("MyMethod") 搭配 types 陣列中的適當參數。

另請參閱

• MethodInfo
• String
• DefaultBinder
• ParameterModifier
• GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
• GetMethods()