Type.GetMethods Метод

Определение

Возвращает методы текущего объекта Type.Gets the methods of the current Type.

Перегрузки

GetMethods(BindingFlags)

При переопределении в производном классе ищет методы, определенные для текущего объекта Type, используя указанные ограничения привязки.When overridden in a derived class, searches for the methods defined for the current Type, using the specified binding constraints.

GetMethods()

Возвращает все открытые методы текущего объекта Type.Returns all the public methods of the current Type.

GetMethods(BindingFlags)

При переопределении в производном классе ищет методы, определенные для текущего объекта Type, используя указанные ограничения привязки.When overridden in a derived class, searches for the methods defined for the current Type, using the specified binding constraints.

public:
 abstract cli::array <System::Reflection::MethodInfo ^> ^ GetMethods(System::Reflection::BindingFlags bindingAttr);
public abstract System.Reflection.MethodInfo[] GetMethods (System.Reflection.BindingFlags bindingAttr);
abstract member GetMethods : System.Reflection.BindingFlags -> System.Reflection.MethodInfo[]
Public MustOverride Function GetMethods (bindingAttr As BindingFlags) As MethodInfo()

Параметры

bindingAttr
BindingFlags

Побитовое сочетание значений перечисления, указывающих способ проведения поиска.A bitwise combination of the enumeration values that specify how the search is conducted.

- или --or-

Default для возврата пустого массива.Default to return an empty array.

Возвраты

Массив объектов MethodInfo, представляющий все методы, определенные для текущего типа Type и удовлетворяющие указанным ограничениям привязки.An array of MethodInfo objects representing all methods defined for the current Type that match the specified binding constraints.

- или --or- Пустой массив типа MethodInfo, если для текущего объекта Type не определены методы или ни один из определенных методов не удовлетворяет ограничениям привязки.An empty array of type MethodInfo, if no methods are defined for the current Type, or if none of the defined methods match the binding constraints.

Реализации

Примеры

В следующем примере создается класс с двумя открытыми методами и одним защищенным методом, создается объект Type, соответствующий MyTypeClass, получает все открытые и не являющиеся открытыми методы и отображает их имена.The following example creates a class with two public methods and one protected method, creates a Type object corresponding to MyTypeClass, gets all public and non-public methods, and displays their names.

using namespace System;
using namespace System::Reflection;
using namespace System::Reflection::Emit;

// Create a class having two public methods and one protected method.
public ref class MyTypeClass
{
public:
   void MyMethods(){}

   int MyMethods1()
   {
      return 3;
   }


protected:
   String^ MyMethods2()
   {
      return "hello";
   }
};

void DisplayMethodInfo( array<MethodInfo^>^myArrayMethodInfo )
{
   // Display information for all methods.
   for ( int i = 0; i < myArrayMethodInfo->Length; i++ )
   {
      MethodInfo^ myMethodInfo = dynamic_cast<MethodInfo^>(myArrayMethodInfo[ i ]);
      Console::WriteLine( "\nThe name of the method is {0}.", myMethodInfo->Name );
   }
}

int main()
{
   Type^ myType = MyTypeClass::typeid;
   
   // Get the public methods.
   array<MethodInfo^>^myArrayMethodInfo = myType->GetMethods( static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance | BindingFlags::DeclaredOnly) );
   Console::WriteLine( "\nThe number of public methods is {0}->", myArrayMethodInfo->Length );
   
   // Display all the methods.
   DisplayMethodInfo( myArrayMethodInfo );
   
   // Get the nonpublic methods.
   array<MethodInfo^>^myArrayMethodInfo1 = myType->GetMethods( static_cast<BindingFlags>(BindingFlags::NonPublic | BindingFlags::Instance | BindingFlags::DeclaredOnly) );
   Console::WriteLine( "\nThe number of protected methods is {0}->", myArrayMethodInfo1->Length );
   
   // Display information for all methods.
   DisplayMethodInfo( myArrayMethodInfo1 );
}

using System;
using System.Reflection;
using System.Reflection.Emit;

        // Create a class having two public methods and one protected method.
public class MyTypeClass
{
    public void MyMethods()
    {
    }
    public int MyMethods1() 
    {
        return 3;
    }
    protected String MyMethods2()
    {
        return "hello";
    }
}
public class TypeMain
{
    public static void Main() 
    {
        Type myType =(typeof(MyTypeClass));
        // Get the public methods.
        MethodInfo[] myArrayMethodInfo = myType.GetMethods(BindingFlags.Public|BindingFlags.Instance|BindingFlags.DeclaredOnly);
        Console.WriteLine("\nThe number of public methods is {0}.", myArrayMethodInfo.Length);
        // Display all the methods.
        DisplayMethodInfo(myArrayMethodInfo);
        // Get the nonpublic methods.
        MethodInfo[] myArrayMethodInfo1 = myType.GetMethods(BindingFlags.NonPublic|BindingFlags.Instance|BindingFlags.DeclaredOnly);
        Console.WriteLine("\nThe number of protected methods is {0}.", myArrayMethodInfo1.Length);
        // Display information for all methods.
        DisplayMethodInfo(myArrayMethodInfo1);		
    }
    public static void DisplayMethodInfo(MethodInfo[] myArrayMethodInfo)
    {
        // Display information for all methods.
        for(int i=0;i<myArrayMethodInfo.Length;i++)
        {
            MethodInfo myMethodInfo = (MethodInfo)myArrayMethodInfo[i];
            Console.WriteLine("\nThe name of the method is {0}.", myMethodInfo.Name);
        }
    }
}

Imports System.Reflection
Imports System.Reflection.Emit

' Create a class having two public methods and one protected method.
Public Class MyTypeClass
    Public Sub MyMethods()
    End Sub
    Public Function MyMethods1() As Integer
        Return 3
    End Function 'MyMethods1
    Protected Function MyMethods2() As [String]
        Return "hello"
    End Function 'MyMethods2
End Class
Public Class TypeMain
    Public Shared Sub Main()

        Dim myType As Type = GetType(MyTypeClass)
        ' Get the public methods.
        Dim myArrayMethodInfo As MethodInfo() = myType.GetMethods((BindingFlags.Public Or BindingFlags.Instance Or BindingFlags.DeclaredOnly))
        Console.WriteLine((ControlChars.Cr + "The number of public methods is " & myArrayMethodInfo.Length.ToString() & "."))
        ' Display all the public methods.
        DisplayMethodInfo(myArrayMethodInfo)
        ' Get the nonpublic methods.
        Dim myArrayMethodInfo1 As MethodInfo() = myType.GetMethods((BindingFlags.NonPublic Or BindingFlags.Instance Or BindingFlags.DeclaredOnly))
        Console.WriteLine((ControlChars.Cr + "The number of protected methods is " & myArrayMethodInfo1.Length.ToString() & "."))
        ' Display all the nonpublic methods.
        DisplayMethodInfo(myArrayMethodInfo1)
    End Sub

    Public Shared Sub DisplayMethodInfo(ByVal myArrayMethodInfo() As MethodInfo)
        ' Display information for all methods.
        Dim i As Integer
        For i = 0 To myArrayMethodInfo.Length - 1
            Dim myMethodInfo As MethodInfo = CType(myArrayMethodInfo(i), MethodInfo)
            Console.WriteLine((ControlChars.Cr + "The name of the method is " & myMethodInfo.Name & "."))
        Next i
    End Sub
End Class

Комментарии

Чтобы перегрузить GetMethods(BindingFlags) для успешного получения сведений о методе, аргумент bindingAttr должен включать по крайней мере один из BindingFlags.Instance и BindingFlags.Static, а также хотя бы один из BindingFlags.NonPublic и BindingFlags.Public.For the GetMethods(BindingFlags) overload to successfully retrieve method information, the bindingAttr argument must include at least one of BindingFlags.Instance and BindingFlags.Static, along with at least one of BindingFlags.NonPublic and BindingFlags.Public.

Для определения методов, которые следует включить в поиск, можно использовать следующие флаги фильтра BindingFlags.The following BindingFlags filter flags can be used to define which methods to include in the search:

  • Укажите BindingFlags.Instance, чтобы включить методы экземпляра.Specify BindingFlags.Instance to include instance methods.

  • Укажите BindingFlags.Static, чтобы включить статические методы.Specify BindingFlags.Static to include static methods.

  • Укажите 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. Возвращаются только защищенные и внутренние методы базовых классов. закрытые методы в базовых классах не возвращаются.Only protected and internal methods on base classes are returned; private methods on base classes are not returned.

  • Укажите BindingFlags.FlattenHierarchy, чтобы включить public и protected статические элементы в иерархии. private статические члены в унаследованных классах не включены.Specify BindingFlags.FlattenHierarchy to include public and protected static members up the hierarchy; private static members in inherited classes are not included.

  • Укажите только BindingFlags.Default, чтобы вернуть пустой массив MethodInfo.Specify BindingFlags.Default alone to return an empty MethodInfo array.

Для изменения работы поиска можно использовать следующие флаги модификатора BindingFlags.The following BindingFlags modifier flags can be used to change how the search works:

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

Метод GetMethods не возвращает методы в определенном порядке, таком как алфавит или порядок объявления.The GetMethods method does not return methods in a particular order, such as alphabetical or declaration order. Код не должен зависеть от порядка, в котором возвращаются методы, так как этот порядок меняется.Your code must not depend on the order in which methods are returned, because that order varies.

Если текущий Type представляет сконструированный универсальный тип, этот метод возвращает объекты MethodInfo с параметрами типа, замененными соответствующими аргументами типа.If the current Type represents a constructed generic type, this method returns the MethodInfo objects 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.

Дополнительно

GetMethods()

Возвращает все открытые методы текущего объекта Type.Returns all the public methods of the current Type.

public:
 virtual cli::array <System::Reflection::MethodInfo ^> ^ GetMethods();
public System.Reflection.MethodInfo[] GetMethods ();
abstract member GetMethods : unit -> System.Reflection.MethodInfo[]
override this.GetMethods : unit -> System.Reflection.MethodInfo[]
Public Function GetMethods () As MethodInfo()

Возвраты

Массив объектов MethodInfo, представляющий все открытые методы, определенные для текущего объекта Type.An array of MethodInfo objects representing all the public methods defined for the current Type.

- или --or- Пустой массив типа MethodInfo, если для текущего типа Type открытые методы не определены.An empty array of type MethodInfo, if no public methods are defined for the current Type.

Реализации

Комментарии

Метод GetMethods не возвращает методы в определенном порядке, таком как алфавит или порядок объявления.The GetMethods method does not return methods in a particular order, such as alphabetical or declaration order. Код не должен зависеть от порядка, в котором возвращаются методы, так как этот порядок меняется.Your code must not depend on the order in which methods are returned, because that order varies.

Конструкторы не включаются в массив методов, возвращаемых этим вызовом.Constructors are not included in the array of methods returned by this call. Выполните отдельный вызов GetConstructors(), чтобы получить методы конструктора.Make a separate call to GetConstructors() to get the constructor methods.

В следующей таблице показаны элементы базового класса, возвращаемые методами Get при отражении в типе.The following table shows what members of a base class are returned by the Get methods when reflecting on a type.

Тип членаMember Type СтатическиеStatic Не статический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.
  1. При скрытии по имени и сигнатуре учитываются все части сигнатуры, включая пользовательские модификаторы, возвращаемые типы, типы параметров, 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.

  2. Для отражения свойства и события скрываются по имени и сигнатуре.For reflection, properties and events are hide-by-name-and-signature. Если у вас есть свойство с методом доступа get и Set в базовом классе, но производный класс имеет только метод доступа get, свойство производного класса скрывает свойство базового класса, и вы не сможете получить доступ к методу задания в базовом классе.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.

  3. Настраиваемые атрибуты не являются частью системы общих типов.Custom attributes are not part of the common type system.

Примечание

Нельзя опустить параметры при поиске конструкторов и методов.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 objects 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.

Дополнительно

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