Прочитать на английском

Поделиться через


Type.GetMethod Метод

Определение

Возвращает определенный метод текущей 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, Int32, BindingFlags, Type[])

Выполняет поиск указанного метода, параметры которого соответствуют указанному числу универсальных параметров и типам аргументов, используя указанные ограничения привязки.

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
Исходный код:
Type.cs
Исходный код:
Type.cs

Выполняет поиск указанного метода, параметры которого соответствуют указанному числу универсальных параметров, типам аргументов и модификаторам, используя указанные ограничения привязки и указанное соглашение о вызовах.

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

Параметры

name
String

Строка, содержащая имя общедоступного метода, который требуется получить.

genericParameterCount
Int32

Число параметров универсального типа метода.

bindingAttr
BindingFlags

Побитовое сочетание значений перечисления, указывающее, как выполняется поиск.

-или-

Default для возврата null.

binder
Binder

Объект, который определяет набор свойств и включает привязку, которая может включать выбор перегруженного метода, приведение типов аргументов и вызов элемента через отражение.

-или-

Ссылка на значение NULL (Nothing в Visual Basic) для использования DefaultBinder.

callConvention
CallingConventions

Объект, указывающий набор правил, используемых в отношении порядка и макета аргументов, как передается возвращаемое значение, какие регистры используются для аргументов и как стек очищается.

types
Type[]

Массив объектов Type, представляющих число, порядок и тип параметров для получения метода.

-или-

Пустой массив объектов Type (как указано в поле EmptyTypes), чтобы получить метод, который не принимает параметров.

modifiers
ParameterModifier[]

Массив объектов ParameterModifier, представляющих атрибуты, связанные с соответствующим элементом в массиве types. Для использования только при вызове com-взаимодействия и обрабатываются только параметры, передаваемые по ссылке. Привязка по умолчанию не обрабатывает этот параметр.

Возвращаемое значение

Объект, представляющий метод, соответствующий указанному числу универсальных параметров, типам аргументов, модификаторам, ограничениям привязки и соглашению о вызовах, если найдено; в противном случае null.

Исключения

name null.

-или-

types null.

-или-

Одним из элементов массива types является null.

genericParameterCount отрицательно.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

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

Исходный код:
Type.cs
Исходный код:
Type.cs
Исходный код:
Type.cs

Выполняет поиск указанного метода, параметры которого соответствуют указанным типам аргументов и модификаторам, используя указанные ограничения привязки и указанное соглашение о вызовах.

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

Параметры

name
String

Строка, содержащая имя метода для получения.

bindingAttr
BindingFlags

Побитовое сочетание значений перечисления, указывающее, как выполняется поиск.

-или-

Default для возврата null.

binder
Binder

Объект, который определяет набор свойств и включает привязку, которая может включать выбор перегруженного метода, приведение типов аргументов и вызов элемента через отражение.

-или-

Ссылка на значение NULL (Nothing в Visual Basic) для использования DefaultBinder.

callConvention
CallingConventions

Объект, указывающий набор правил, используемых в отношении порядка и макета аргументов, как передается возвращаемое значение, какие регистры используются для аргументов и как стек очищается.

types
Type[]

Массив объектов Type, представляющих число, порядок и тип параметров для получения метода.

-или-

Пустой массив объектов Type (как указано в поле EmptyTypes), чтобы получить метод, который не принимает параметров.

modifiers
ParameterModifier[]

Массив объектов ParameterModifier, представляющих атрибуты, связанные с соответствующим элементом в массиве types. Для использования только при вызове com-взаимодействия и обрабатываются только параметры, передаваемые по ссылке. Привязка по умолчанию не обрабатывает этот параметр.

Возвращаемое значение

Объект, представляющий метод, соответствующий указанным требованиям, при обнаружении; в противном случае null.

Реализации

Исключения

Несколько методов находятся с указанным именем и соответствуют указанным ограничениям привязки.

name null.

-или-

types null.

-или-

Одним из элементов в types является null.

types является многомерным.

-или-

modifiers является многомерным.

Примеры

В следующем примере обнаруживаются определенные перегрузки MethodA, указание ограничений привязки, соглашений о вызовах и различных типов аргументов.

Примечание

В примере Visual C# 2005 требуется параметр компилятора /unsafe.


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. ParameterModifier используется только при вызове COM-взаимодействия, а обрабатываются только параметры, передаваемые по ссылке.

В следующей таблице показано, какие элементы базового класса возвращаются методами GetXXX при отражении типа.

Тип члена Статический Нестатическое
Конструктор Нет Нет
Поле Нет Да. Поле всегда скрывается по имени и подписи.
Событие Неприменимо Правило системы общего типа заключается в том, что наследование совпадает с методами, реализующими свойство. Отражение обрабатывает свойства как скрытие по имени и сигнатуре. См. примечание 2 ниже.
Метод Нет Да. Метод (как виртуальный, так и не виртуальный) может быть скрыт по имени или скрытию по имени и сигнатуре.
Вложенный тип Нет Нет
Свойство Неприменимо Правило системы общего типа заключается в том, что наследование совпадает с методами, реализующими свойство. Отражение обрабатывает свойства как скрытие по имени и сигнатуре. См. примечание 2 ниже.
  1. Скрытие по имени и сигнатуре учитывает все части подписи, включая настраиваемые модификаторы, возвращаемые типы, типы параметров, sentinels и неуправляемые соглашения о вызовах. Это двоичное сравнение.

  2. Для отражения свойства и события скрываются по имени и сигнатуре. Если у вас есть свойство с методом get и набором доступа в базовом классе, но производный класс имеет только метод доступа, производное свойство класса скрывает свойство базового класса, и вы не сможете получить доступ к методу задания в базовом классе.

  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>", а не для метода с именем MyMethod с одним универсальным аргументом типа int.

См. также раздел

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

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

Исходный код:
Type.cs
Исходный код:
Type.cs
Исходный код:
Type.cs

Выполняет поиск указанного метода, параметры которого соответствуют указанному числу универсальных параметров, типам аргументов и модификаторам, используя указанные ограничения привязки.

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

Параметры

name
String

Строка, содержащая имя общедоступного метода, который требуется получить.

genericParameterCount
Int32

Число параметров универсального типа метода.

bindingAttr
BindingFlags

Побитовое сочетание значений перечисления, указывающее, как выполняется поиск.

-или-

Default для возврата null.

binder
Binder

Объект, который определяет набор свойств и включает привязку, которая может включать выбор перегруженного метода, приведение типов аргументов и вызов элемента через отражение.

-или-

Ссылка на значение NULL (Nothing в Visual Basic) для использования DefaultBinder.

types
Type[]

Массив объектов Type, представляющих число, порядок и тип параметров для получения метода.

-или-

Пустой массив объектов Type (как указано в поле EmptyTypes), чтобы получить метод, который не принимает параметров.

modifiers
ParameterModifier[]

Массив объектов ParameterModifier, представляющих атрибуты, связанные с соответствующим элементом в массиве types. Для использования только при вызове com-взаимодействия и обрабатываются только параметры, передаваемые по ссылке. Привязка по умолчанию не обрабатывает этот параметр.

Возвращаемое значение

Объект, представляющий метод, соответствующий указанному числу универсальных параметров, типам аргументов, модификаторам и ограничениям привязки, если найдено; в противном случае null.

Исключения

name null.

-или-

types null.

-или-

Одним из элементов массива types является null.

genericParameterCount отрицательно.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

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

Исходный код:
Type.cs
Исходный код:
Type.cs
Исходный код:
Type.cs

Выполняет поиск указанного метода, параметры которого соответствуют указанным типам аргументов и модификаторам, используя указанные ограничения привязки.

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

Параметры

name
String

Строка, содержащая имя метода для получения.

bindingAttr
BindingFlags

Побитовое сочетание значений перечисления, указывающее, как выполняется поиск.

-или-

Default для возврата null.

binder
Binder

Объект, который определяет набор свойств и включает привязку, которая может включать выбор перегруженного метода, приведение типов аргументов и вызов элемента через отражение.

-или-

Ссылка на значение NULL (Nothing в Visual Basic) для использования DefaultBinder.

types
Type[]

Массив объектов Type, представляющих число, порядок и тип параметров для получения метода.

-или-

Пустой массив объектов Type (как указано в поле EmptyTypes), чтобы получить метод, который не принимает параметров.

modifiers
ParameterModifier[]

Массив объектов ParameterModifier, представляющих атрибуты, связанные с соответствующим элементом в массиве types. Для использования только при вызове com-взаимодействия и обрабатываются только параметры, передаваемые по ссылке. Привязка по умолчанию не обрабатывает этот параметр.

Возвращаемое значение

Объект, представляющий метод, соответствующий указанным требованиям, при обнаружении; в противном случае null.

Реализации

Исключения

Несколько методов находятся с указанным именем и соответствуют указанным ограничениям привязки.

name null.

-или-

types null.

-или-

Одним из элементов в types является null.

types является многомерным.

-или-

modifiers является многомерным.

Примеры

В следующем примере обнаруживаются определенные перегрузки MethodA, определяющие ограничения привязки и различные типы аргументов.

Примечание

В примере Visual C# 2005 требуется параметр компилятора /unsafe.


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. ParameterModifier используется только при вызове COM-взаимодействия, а обрабатываются только параметры, передаваемые по ссылке.

Следующие 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>", а не для метода с именем MyMethod с одним универсальным аргументом типа int.

См. также раздел

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

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

Исходный код:
Type.cs
Исходный код:
Type.cs
Исходный код:
Type.cs

Выполняет поиск указанного общедоступного метода, параметры которого соответствуют указанному числу универсальных параметров, типам аргументов и модификаторам.

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

Параметры

name
String

Строка, содержащая имя общедоступного метода, который требуется получить.

genericParameterCount
Int32

Число параметров универсального типа метода.

types
Type[]

Массив объектов Type, представляющих число, порядок и тип параметров для получения метода.

-или-

Пустой массив объектов Type (как указано в поле EmptyTypes), чтобы получить метод, который не принимает параметров.

modifiers
ParameterModifier[]

Массив объектов ParameterModifier, представляющих атрибуты, связанные с соответствующим элементом в массиве types. Для использования только при вызове com-взаимодействия и обрабатываются только параметры, передаваемые по ссылке. Привязка по умолчанию не обрабатывает этот параметр.

Возвращаемое значение

Объект, представляющий открытый метод, соответствующий указанному числу универсальных параметров, типам аргументов и модификаторам, если он найден; в противном случае null.

Исключения

name null.

-или-

types null.

-или-

Одним из элементов массива types является null.

genericParameterCount отрицательно.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

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

Исходный код:
Type.cs

Выполняет поиск указанного метода, параметры которого соответствуют указанному числу универсальных параметров и типам аргументов, используя указанные ограничения привязки.

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

Параметры

name
String

Строка, содержащая имя метода для получения.

genericParameterCount
Int32

Число параметров универсального типа метода.

bindingAttr
BindingFlags

Побитовое сочетание значений перечисления, указывающее, как выполняется поиск.

-или-

Default для возврата null.

types
Type[]

Массив объектов Type, представляющих число, порядок и тип параметров для получения метода.

-или-

Пустой массив объектов Type (как указано в поле EmptyTypes), чтобы получить метод, который не принимает параметров.

Возвращаемое значение

Объект, представляющий метод, соответствующий указанному числу универсальных параметров, типам аргументов и ограничениям привязки, если найдено; в противном случае null.

Применяется к

.NET 9
Продукт Версии
.NET 9

GetMethod(String, BindingFlags)

Исходный код:
Type.cs
Исходный код:
Type.cs
Исходный код:
Type.cs

Выполняет поиск указанного метода с помощью указанных ограничений привязки.

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

Параметры

name
String

Строка, содержащая имя метода для получения.

bindingAttr
BindingFlags

Побитовое сочетание значений перечисления, указывающее, как выполняется поиск.

-или-

Default для возврата null.

Возвращаемое значение

Объект, представляющий метод, соответствующий указанным требованиям, при обнаружении; в противном случае null.

Реализации

Исключения

Несколько методов находятся с указанным именем и соответствуют указанным ограничениям привязки.

Примеры

В следующем примере возвращается метод, соответствующий указанным флагам привязки.

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 можно использовать для изменения работы поиска:

Дополнительные сведения см. в System.Reflection.BindingFlags.

Если метод перегружен и несколько перегрузки соответствуют ограничениям, заданным аргументом bindingAttr, метод вызывает исключение AmbiguousMatchException. В следующем примере создается исключение, так как:

  • Тип TestClass имеет две перегрузки общедоступного экземпляра метода DisplayValue, DisplayValue(String) и DisplayValue(String, Object[]).

  • Тип TestClass имеет два перегрузки общедоступного экземпляра метода Equals, один из которых наследуется от Object: Equals(TestClass) и Equals(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 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>", а не для метода с именем MyMethod с одним универсальным аргументом типа int.

См. также раздел

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

GetMethod(String, BindingFlags, Type[])

Исходный код:
Type.cs
Исходный код:
Type.cs
Исходный код:
Type.cs

Выполняет поиск указанного метода, параметры которого соответствуют указанным типам аргументов, используя указанные ограничения привязки.

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

Параметры

name
String

Строка, содержащая имя метода для получения.

bindingAttr
BindingFlags

Побитовое сочетание значений перечисления, указывающее, как выполняется поиск. -или- Значение по умолчанию для возврата null.

types
Type[]

Массив объектов Type, представляющих число, порядок и тип параметров для получения метода. -или- Пустой массив объектов Type (как указано в поле EmptyTypes), чтобы получить метод, который не принимает параметров.

Возвращаемое значение

Объект, представляющий метод, соответствующий указанным требованиям, при обнаружении; в противном случае null.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET 6, 7, 8, 9

GetMethod(String, Int32, Type[])

Исходный код:
Type.cs
Исходный код:
Type.cs
Исходный код:
Type.cs

Выполняет поиск указанного общедоступного метода, параметры которого соответствуют указанному числу универсальных параметров и типам аргументов.

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

Параметры

name
String

Строка, содержащая имя общедоступного метода, который требуется получить.

genericParameterCount
Int32

Число параметров универсального типа метода.

types
Type[]

Массив объектов Type, представляющих число, порядок и тип параметров для получения метода.

-или-

Пустой массив объектов Type (как указано в поле EmptyTypes), чтобы получить метод, который не принимает параметров.

Возвращаемое значение

Объект, представляющий открытый метод, параметры которого соответствуют указанному числу универсальных параметров и типам аргументов, если найдено; в противном случае null.

Исключения

name null.

-или-

types null.

-или-

Одним из элементов массива types является null.

genericParameterCount отрицательно.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

GetMethod(String, Type[])

Исходный код:
Type.cs
Исходный код:
Type.cs
Исходный код:
Type.cs

Выполняет поиск указанного общедоступного метода, параметры которого соответствуют указанным типам аргументов.

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

Параметры

name
String

Строка, содержащая имя общедоступного метода, который требуется получить.

types
Type[]

Массив объектов Type, представляющих число, порядок и тип параметров для получения метода.

-или-

Пустой массив объектов Type (как указано в поле EmptyTypes), чтобы получить метод, который не принимает параметров.

Возвращаемое значение

Объект, представляющий открытый метод, параметры которого соответствуют указанным типам аргументов, если найдено; в противном случае null.

Реализации

Исключения

Несколько методов найдены с указанным именем и указанными параметрами.

name null.

-или-

types null.

-или-

Одним из элементов в types является null.

types является многомерным.

Примеры

В следующем примере обнаруживаются определенные перегрузки MethodA, указывающие различные типы аргументов.

Примечание

В примере Visual C# 2005 требуется параметр компилятора /unsafe.


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

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)

В примере определяется метод GetAddMethod, который получает соответствующий объект MethodInfo. Чтобы указать аргумент types для открытого универсального типа, он вызывает метод Type.GetGenericArguments. Чтобы указать аргумент types для закрытого универсального типа, он извлекает значение свойства Type.GenericTypeArguments.

Комментарии

Поиск name учитывает регистр. Поиск включает методы общедоступных статических и общедоступных экземпляров.

Примечание

Параметры нельзя опустить при поиске конструкторов и методов. При вызове можно опустить только параметры.

Если текущий Type представляет созданный универсальный тип, этот метод возвращает MethodInfo с параметрами типа, замененными соответствующими аргументами типа.

Если текущий Type представляет параметр типа в определении универсального типа или универсального метода, этот метод выполняет поиск методов ограничения класса или методы Object, если ограничения класса отсутствуют.

Примечание

Параметр name не может включать аргументы типа. Например, код C# GetMethod("MyGenericMethod<int>") ищет метод с текстовым именемMyGenericMethod<int>, а не для метода с именем MyGenericMethod с одним универсальным аргументом типа int. Вместо этого используйте GetMethod("MyGenericMethod") с соответствующим параметром в массиве types.

См. также раздел

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

GetMethod(String)

Исходный код:
Type.cs
Исходный код:
Type.cs
Исходный код:
Type.cs

Выполняет поиск общедоступного метода с указанным именем.

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

Параметры

name
String

Строка, содержащая имя общедоступного метода, который требуется получить.

Возвращаемое значение

Объект, представляющий открытый метод с указанным именем, если он найден; в противном случае null.

Реализации

Исключения

Несколько методов найдены с указанным именем.

Примеры

В следующем примере возвращается метод с именем MethodA.


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.

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, который однозначно идентифицирует метод. Например, если исключение создается, так как тип имеет статическую и перегрузку экземпляра, можно указать аргумент bindingAttrBindingFlags.InstanceOrBindingFlags.Instance.

  • Вызов перегрузки метода GetMethod, который включает параметр types, определяющий типы параметров метода.

  • Вызовите метод GetMethods(), чтобы получить массив, содержащий все открытые методы, принадлежащие типу. Затем можно выполнить итерацию, чтобы определить повторяющиеся методы с именем name.

Если текущий Type представляет созданный универсальный тип, этот метод возвращает MethodInfo с параметрами типа, замененными соответствующими аргументами типа.

Если текущий Type представляет параметр типа в определении универсального типа или универсального метода, этот метод выполняет поиск методов ограничения класса или методы Object, если ограничения класса отсутствуют.

Примечание

Для универсальных методов не включайте аргументы типа в name. Например, код C# GetMember("MyMethod<int>") ищет элемент с текстовым именем "MyMethod<int>", а не для метода с именем MyMethod с одним универсальным аргументом типа int.

См. также раздел

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

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

Исходный код:
Type.cs
Исходный код:
Type.cs
Исходный код:
Type.cs

Выполняет поиск указанного общедоступного метода, параметры которого соответствуют указанным типам аргументов и модификаторам.

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

Параметры

name
String

Строка, содержащая имя общедоступного метода, который требуется получить.

types
Type[]

Массив объектов Type, представляющих число, порядок и тип параметров для получения метода.

-или-

Пустой массив объектов Type (как указано в поле EmptyTypes), чтобы получить метод, который не принимает параметров.

modifiers
ParameterModifier[]

Массив объектов ParameterModifier, представляющих атрибуты, связанные с соответствующим элементом в массиве types. Для использования только при вызове com-взаимодействия и обрабатываются только параметры, передаваемые по ссылке. Привязка по умолчанию не обрабатывает этот параметр.

Возвращаемое значение

Объект, представляющий открытый метод, соответствующий указанным требованиям, если он найден; в противном случае null.

Реализации

Исключения

Несколько методов найдены с указанным именем и указанными параметрами.

name null.

-или-

types null.

-или-

Одним из элементов в types является null.

types является многомерным.

-или-

modifiers является многомерным.

Комментарии

Хотя привязка по умолчанию не обрабатывает ParameterModifier (параметр modifiers), можно использовать абстрактный класс System.Reflection.Binder для записи пользовательского привязки, выполняющего обработку modifiers. ParameterModifier используется только при вызове COM-взаимодействия, а обрабатываются только параметры, передаваемые по ссылке.

Поиск name учитывает регистр. Поиск включает методы общедоступных статических и общедоступных экземпляров.

Примечание

Параметры нельзя опустить при поиске конструкторов и методов. При вызове можно опустить только параметры.

Если текущий Type представляет созданный универсальный тип, этот метод возвращает MethodInfo с параметрами типа, замененными соответствующими аргументами типа.

Если текущий Type представляет параметр типа в определении универсального типа или универсального метода, этот метод выполняет поиск методов ограничения класса или методы Object, если ограничения класса отсутствуют.

Примечание

Для универсальных методов не включайте аргументы типа в name. Например, код C# GetMethod("MyMethod<int>") ищет элемент с текстовым именем "MyMethod<int>", а не для метода с именем MyMethod с одним универсальным аргументом типа int. Вместо этого используйте GetMethod("MyMethod") с соответствующим параметром в массиве types.

См. также раздел

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1