GetMethod Method (String, BindingFlags)

Type::GetMethod Method (String^, BindingFlags)

 

Searches for the specified method, using the specified binding constraints.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public:
virtual MethodInfo^ GetMethod(
	String^ name,
	BindingFlags bindingAttr
) sealed

Parameters

name
Type: System::String^

The string containing the name of the method to get.

bindingAttr
Type: System.Reflection::BindingFlags

A bitmask comprised of one or more BindingFlags that specify how the search is conducted.

-or-

Zero, to return null.

Return Value

Type: System.Reflection::MethodInfo^

An object representing the method that matches the specified requirements, if found; otherwise, null.

Exception Condition
AmbiguousMatchException

More than one method is found with the specified name and matching the specified binding constraints.

ArgumentNullException

name is null.

The following BindingFlags filter flags can be used to define which methods to include in the search:

The following BindingFlags modifier flags can be used to change how the search works:

See System.Reflection::BindingFlags for more information.

If a method is overloaded and more than one overload meets the constraints specified by the bindingAttr argument, the method throws an AmbiguousMatchException exception. In the following example, an exception is thrown because:

  • The TestClass type has two public instance overloads of the DisplayValue method, DisplayValue(String) and DisplayValue(String, Object[]).

  • The TestClass type has two public instance overloads of the Equals method, one of which is inherited from Object: Equals(TestClass) and Equals(Object).

No code example is currently available or this language may not be supported.

You can do one of the following to retrieve a specific method:

  • Change the binding constraints. In the previous example, attempting to retrieve a public instance Equals method that is declared by the type and not inherited successfully retrieves Equals(TestClass).

  • Call an overload of the GetMethod method that includes a types parameter which defines the types of the method's parameters.

  • Call the GetMethods(BindingFlags) method to retrieve an array containing all of the methods belonging to a type that have the specified binding attributes. You can then iterate it to identify the duplicate methods named name. This approach is illustrated in the previous example's handler for the AmbiguousMatchException exception.

If the current Type represents a constructed generic type, this method returns the MethodInfo with the type parameters replaced by the appropriate type arguments.

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.

System_CAPS_noteNote

For generic methods, do not include the type arguments in name. For example, the C# code GetMember("MyMethod<int>") searches for a member with the text name "MyMethod<int>", rather than for a method named MyMethod that has one generic argument of type int.

The following example gets the method that matches the specified binding flags.

using namespace System;
using namespace System::Reflection;
public ref class Program
{

    public:

        // Method to get:
        void MethodA() { }

    };

    int main()
    {

        // Get MethodA()
        MethodInfo^ mInfo = Program::typeid->GetMethod("MethodA",
            static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance));
        Console::WriteLine("Found method: {0}", mInfo );

    }

.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show:
© 2016 Microsoft