Type.GetMethod Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Obtém um método específico do Typeatual.

Sobrecargas

GetMethod(String, Int32, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])	Pesquisa o método especificado cujos parâmetros correspondem à contagem de parâmetros genéricos, tipos de argumento e modificadores especificados, usando as restrições de associação especificadas e a convenção de chamada especificada.
GetMethod(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])	Pesquisa o método especificado cujos parâmetros correspondem aos tipos de argumento e modificadores especificados, usando as restrições de associação especificadas e a convenção de chamada especificada.
GetMethod(String, Int32, BindingFlags, Binder, Type[], ParameterModifier[])	Pesquisa o método especificado cujos parâmetros correspondem à contagem de parâmetros genéricos, tipos de argumento e modificadores especificados, usando as restrições de associação especificadas.
GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])	Pesquisa o método especificado cujos parâmetros correspondem aos tipos de argumento e modificadores especificados, usando as restrições de associação especificadas.
GetMethod(String, Int32, Type[], ParameterModifier[])	Pesquisa o método público especificado cujos parâmetros correspondem à contagem de parâmetros genéricos, tipos de argumento e modificadores especificados.
GetMethod(String, BindingFlags)	Pesquisa o método especificado usando as restrições de associação especificadas.
GetMethod(String, BindingFlags, Type[])	Pesquisa o método especificado cujos parâmetros correspondem aos tipos de argumento especificados, usando as restrições de associação especificadas.
GetMethod(String, Int32, Type[])	Pesquisa o método público especificado cujos parâmetros correspondem aos tipos de argumento e contagem de parâmetros genéricos especificados.
GetMethod(String, Type[])	Pesquisa o método público especificado cujos parâmetros correspondem aos tipos de argumento especificados.
GetMethod(String)	Pesquisa o método público com o nome especificado.
GetMethod(String, Type[], ParameterModifier[])	Pesquisa o método público especificado cujos parâmetros correspondem aos tipos de argumento e modificadores especificados.

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

Origem:

Type.cs

Pesquisa o método especificado cujos parâmetros correspondem à contagem de parâmetros genéricos, tipos de argumento e modificadores especificados, usando as restrições de associação especificadas e a convenção de chamada especificada.

public:
 System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, int genericParameterCount, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, System::Reflection::CallingConventions callConvention, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);

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

member this.GetMethod : string * int * System.Reflection.BindingFlags * System.Reflection.Binder * System.Reflection.CallingConventions * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo

Public Function GetMethod (name As String, genericParameterCount As Integer, bindingAttr As BindingFlags, binder As Binder, callConvention As CallingConventions, types As Type(), modifiers As ParameterModifier()) As MethodInfo

Parâmetros

name

String

A cadeia de caracteres que contém o nome do método público a ser obtido.

genericParameterCount

Int32

O número de parâmetros de tipo genérico do método.

bindingAttr

BindingFlags

Uma combinação bit a bit dos valores de enumeração que especificam como a pesquisa é conduzida.

-ou-

Default retornar null.

binder

Binder

Um objeto que define um conjunto de propriedades e habilita a associação, que pode envolver a seleção de um método sobrecarregado, a coerção de tipos de argumento e a invocação de um membro por meio da reflexão.

-ou-

Uma referência nula (Nothing no Visual Basic) para usar o DefaultBinder.

callConvention

CallingConventions

O objeto que especifica o conjunto de regras a ser usado em relação à ordem e ao layout dos argumentos, como o valor retornado é passado, quais registros são usados para argumentos e como a pilha é limpa.

types

Type[]

Uma matriz de objetos Type que representam o número, a ordem e o tipo dos parâmetros a serem obtidos pelo método.

-ou-

Uma matriz vazia de objetos Type (conforme fornecido pelo campo EmptyTypes) para obter um método que não usa parâmetros.

modifiers

ParameterModifier[]

Uma matriz de objetos ParameterModifier que representam os atributos associados ao elemento correspondente na matriz types. Para ser usado somente ao chamar por meio da interoperabilidade COM, somente os parâmetros que são passados por referência são tratados. O associador padrão não processa esse parâmetro.

Retornos

MethodInfo

Um objeto que representa o método que corresponde à contagem de parâmetros genéricos especificada, tipos de argumento, modificadores, restrições de associação e convenção de chamada, se encontrado; caso contrário, null.

Exceções

ArgumentNullException

name é null.

-ou-

types é null.

-ou-

Um dos elementos na matriz types é null.

ArgumentException

genericParameterCount é negativo.

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

Origem:

Type.cs

Pesquisa o método especificado cujos parâmetros correspondem aos tipos de argumento e modificadores especificados, usando as restrições de associação especificadas e a convenção de chamada especificada.

public:
 System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, System::Reflection::CallingConventions callConvention, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);

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

member this.GetMethod : string * System.Reflection.BindingFlags * System.Reflection.Binder * System.Reflection.CallingConventions * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo

Public Function GetMethod (name As String, bindingAttr As BindingFlags, binder As Binder, callConvention As CallingConventions, types As Type(), modifiers As ParameterModifier()) As MethodInfo

Parâmetros

name

String

A cadeia de caracteres que contém o nome do método a ser obtido.

bindingAttr

BindingFlags

Uma combinação bit a bit dos valores de enumeração que especificam como a pesquisa é conduzida.

-ou-

Default retornar null.

binder

Binder

Um objeto que define um conjunto de propriedades e habilita a associação, que pode envolver a seleção de um método sobrecarregado, a coerção de tipos de argumento e a invocação de um membro por meio da reflexão.

-ou-

Uma referência nula (Nothing no Visual Basic) para usar o DefaultBinder.

callConvention

CallingConventions

O objeto que especifica o conjunto de regras a ser usado em relação à ordem e ao layout dos argumentos, como o valor retornado é passado, quais registros são usados para argumentos e como a pilha é limpa.

types

Type[]

Uma matriz de objetos Type que representam o número, a ordem e o tipo dos parâmetros a serem obtidos pelo método.

-ou-

Uma matriz vazia de objetos Type (conforme fornecido pelo campo EmptyTypes) para obter um método que não usa parâmetros.

modifiers

ParameterModifier[]

Uma matriz de objetos ParameterModifier que representam os atributos associados ao elemento correspondente na matriz types. Para ser usado somente ao chamar por meio da interoperabilidade COM, somente os parâmetros que são passados por referência são tratados. O associador padrão não processa esse parâmetro.

Retornos

MethodInfo

Um objeto que representa o método que corresponde aos requisitos especificados, se encontrado; caso contrário, null.

Exceções

AmbiguousMatchException

Mais de um método é encontrado com o nome especificado e correspondendo às restrições de associação especificadas.

ArgumentNullException

name é null.

-ou-

types é null.

-ou-

Um dos elementos no types é null.

ArgumentException

types é multidimensional.

-ou-

modifiers é multidimensional.

Exemplos

O exemplo a seguir encontra sobrecargas específicas de MethodA, especificando restrições de associação, convenções de chamada e uma variedade de tipos de argumento.

Nota

O exemplo do Visual C# 2005 requer a opção /unsafe compilador.

using namespace System;
using namespace System::Reflection;

public ref class Program
{

public:
    // Methods to get:

    void MethodA(int i, int j) { }

    void MethodA(array<int>^ iarry) { }

    void MethodA(double *ip) { }

    // Method that takes a managed reference paramter.
    void MethodA(int% r) {}
};

int main()
{
    MethodInfo^ mInfo;


    // Get MethodA(int i, int j)
    mInfo = Program::typeid->GetMethod("MethodA",
        BindingFlags::Public | BindingFlags::Instance,
        nullptr,
        CallingConventions::Any,
        gcnew array<Type^> {int::typeid, int::typeid},
        nullptr);
    Console::WriteLine("Found method: {0}", mInfo );

    // Get  MethodA(array<int>^ iarry)
    mInfo = Program::typeid->GetMethod("MethodA",
        BindingFlags::Public | BindingFlags::Instance,
        nullptr,
        CallingConventions::Any,
        gcnew array<Type^> {int::typeid->MakeArrayType()},
        nullptr);
    Console::WriteLine("Found method: {0}", mInfo );

    // Get MethodA(double *ip)
    mInfo = Program::typeid->GetMethod("MethodA",
        BindingFlags::Public | BindingFlags::Instance,
        nullptr,
        CallingConventions::Any,
        gcnew array<Type^> {double::typeid->MakePointerType()},
        nullptr);
    Console::WriteLine("Found method: {0}", mInfo );

    // Get MethodA(int% r)
    mInfo = Program::typeid->GetMethod("MethodA",
        BindingFlags::Public | BindingFlags::Instance,
        nullptr,
        CallingConventions::Any,
        gcnew array<Type^> {int::typeid->MakeByRefType()},
        nullptr);
    Console::WriteLine("Found method: {0}", mInfo );

}

using System;
using System.Reflection;

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

open System.Reflection

type Program() =
    // Methods to get:
    member _.MethodA(i: int, j: int) = ()

    member _.MethodA(i: int[]) = ()
    
    member _.MethodA(i: int nativeptr) = ()

    member _.MethodA(r: int byref) = ()

    // Method that takes an outref parameter:
    member _.MethodA(i: int, o: int outref) = o <- 100

do
    // Get MethodA(int i, int j)
    let mInfo = 
        typeof<Program>.GetMethod("MethodA", BindingFlags.Public ||| BindingFlags.Instance, null, CallingConventions.Any, [| typeof<int>; typeof<int> |], null)
    printfn $"Found method: {mInfo}"

    // Get MethodA(int[] i)
    let mInfo = 
        typeof<Program>.GetMethod("MethodA", BindingFlags.Public ||| BindingFlags.Instance, null, CallingConventions.Any, [| typeof<int[]> |], null)
    printfn $"Found method: {mInfo}"

    // Get MethodA(int* i)
    let mInfo = 
        typeof<Program>.GetMethod("MethodA", BindingFlags.Public ||| BindingFlags.Instance, null, CallingConventions.Any, [| typeof<int>.MakePointerType() |], null)
    printfn $"Found method: {mInfo}"

    // Get MethodA(ref int r)
    let mInfo = 
        typeof<Program>.GetMethod("MethodA", BindingFlags.Public ||| BindingFlags.Instance, null, CallingConventions.Any, [| typeof<int>.MakeByRefType() |], null)
    printfn $"Found method: {mInfo}"

    // Get MethodA(int i, out int o)
    let mInfo = 
        typeof<Program>.GetMethod("MethodA", BindingFlags.Public ||| BindingFlags.Instance, null, CallingConventions.Any, [| typeof<int>; typeof<int>.MakeByRefType() |], null)
    printfn $"Found method: {mInfo}"

Imports System.Reflection
Imports System.Runtime.InteropServices

Class Program

    ' Methods to get:
    
    Public Overloads Sub MethodA(ByVal i As Integer, ByVal l As Long)

    End Sub

    Public Overloads Sub MethodA(ByVal i() As Integer)

    End Sub

    Public Overloads Sub MethodA(ByRef r As Integer)

    End Sub

    ' Method that takes an integer and an out parameter. Note that an
    ' Imports reference is needed to System.Runtime.InteropServices
    ' for the <OutAttribute>, which can be shortened to <Out>.
    Public Overloads Sub MethodA(ByVal i As Integer, <Out()> ByRef o As Integer)
        o = 100
    End Sub

    Public Shared Sub Main(ByVal args() As String)
        Dim mInfo As MethodInfo

        ' Get MethodA(ByVal i As Integer, ByVal l As Long)
        mInfo = GetType(Program).GetMethod("MethodA", _
            BindingFlags.Public Or BindingFlags.Instance, _
            Nothing, _
            CallingConventions.Any, _
            New Type() {GetType(System.Int32), _
            GetType(System.Int64)}, _
            Nothing)
        Console.WriteLine("Found method: {0}", mInfo)

        ' Get  MethodA(ByVal i() As Integer)
        mInfo = GetType(Program).GetMethod("MethodA", _
            BindingFlags.Public Or BindingFlags.Instance, _
            Nothing, _
            CallingConventions.Any, _
            New Type() {GetType(System.Int32())}, _
            Nothing)
        Console.WriteLine("Found method: {0}", mInfo)

        ' Get MethodA(ByRef r As Integer)
        mInfo = GetType(Program).GetMethod("MethodA", _
        BindingFlags.Public Or BindingFlags.Instance, _
        Nothing, _
        CallingConventions.Any, _
        New Type() {GetType(System.Int32).MakeByRefType}, _
        Nothing)
        Console.WriteLine("Found method: {0}", mInfo)

        ' Get MethodA(ByVal i As Integer, <Out()> ByRef o As Integer)
        mInfo = GetType(Program).GetMethod("MethodA", _
        BindingFlags.Public Or BindingFlags.Instance, _
        Nothing, _
        CallingConventions.Any, _
        New Type() {GetType(System.Int32), GetType(System.Int32).MakeByRefType}, _
        Nothing)
        Console.WriteLine("Found method: {0}", mInfo)

    End Sub
End Class

Comentários

Embora o associador padrão não processe ParameterModifier (o parâmetro modifiers), você pode usar a classe System.Reflection.Binder abstrata para escrever um associador personalizado que processa modifiers. ParameterModifier só é usado ao chamar por meio da interoperabilidade COM e somente os parâmetros que são passados por referência são tratados.

A tabela a seguir mostra quais membros de uma classe base são retornados pelos métodos GetXXX ao refletir sobre um tipo.

Tipo de Membro	Estático	Não estático
Construtor	Não	Não
Campo	Não	Sim. Um campo é sempre hide-by-name-and-signature.
Acontecimento	Não aplicável	A regra do sistema de tipo comum é que a herança é a mesma dos métodos que implementam a propriedade. A reflexão trata as propriedades como hide-by-name-and-signature. Veja a observação 2 abaixo.
Método	Não	Sim. Um método (virtual e não virtual) pode ser hide-by-name ou hide-by-name-and-signature.
Tipo aninhado	Não	Não
Propriedade	Não aplicável	A regra do sistema de tipo comum é que a herança é a mesma dos métodos que implementam a propriedade. A reflexão trata as propriedades como hide-by-name-and-signature. Veja a observação 2 abaixo.

1. Ocultar por nome e assinatura considera todas as partes da assinatura, incluindo modificadores personalizados, tipos de retorno, tipos de parâmetro, sentinelas e convenções de chamada não gerenciadas. Essa é uma comparação binária.

2. Para reflexão, as propriedades e os eventos são hide-by-name-and-signature. Se você tiver uma propriedade com um acessador get e um set na classe base, mas a classe derivada tiver apenas um acessador get, a propriedade de classe derivada ocultará a propriedade de classe base e você não poderá acessar o setter na classe base.

3. Atributos personalizados não fazem parte do sistema de tipos comuns.

Os seguintes sinalizadores de filtro de BindingFlags podem ser usados para definir quais métodos incluir na pesquisa:

• Você deve especificar BindingFlags.Instance ou BindingFlags.Static para obter um retorno.

• Especifique BindingFlags.Public para incluir métodos públicos na pesquisa.

• Especifique BindingFlags.NonPublic para incluir métodos não públicos (ou seja, métodos privados, internos e protegidos) na pesquisa.

• Especifique BindingFlags.FlattenHierarchy para incluir membros estáticos public e protected na hierarquia; private membros estáticos em classes herdadas não estão incluídos.

Os seguintes sinalizadores modificador de BindingFlags podem ser usados para alterar o funcionamento da pesquisa:

• BindingFlags.IgnoreCase ignorar o caso de name.

• BindingFlags.DeclaredOnly pesquisar apenas os métodos declarados no Type, não os métodos que foram simplesmente herdados.

Consulte System.Reflection.BindingFlags para obter mais informações.

Nota

Você não pode omitir parâmetros ao procurar construtores e métodos. Você só pode omitir parâmetros ao invocar.

Se o Type atual representar um tipo genérico construído, esse método retornará o MethodInfo com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.

Se o Type atual representar um parâmetro de tipo na definição de um tipo genérico ou método genérico, esse método pesquisará os métodos da restrição de classe ou os métodos de Object se não houver nenhuma restrição de classe.

Nota

Para métodos genéricos, não inclua os argumentos de tipo em name. Por exemplo, o código C# GetMember("MyMethod<int>") pesquisa um membro com o nome de texto "MyMethod<int>", em vez de um método chamado MyMethod que tem um argumento genérico do tipo int.

Confira também

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

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

Origem:

Type.cs

Pesquisa o método especificado cujos parâmetros correspondem à contagem de parâmetros genéricos, tipos de argumento e modificadores especificados, usando as restrições de associação especificadas.

public:
 System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, int genericParameterCount, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);

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

member this.GetMethod : string * int * System.Reflection.BindingFlags * System.Reflection.Binder * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo

Public Function GetMethod (name As String, genericParameterCount As Integer, bindingAttr As BindingFlags, binder As Binder, types As Type(), modifiers As ParameterModifier()) As MethodInfo

Parâmetros

name

String

A cadeia de caracteres que contém o nome do método público a ser obtido.

genericParameterCount

Int32

O número de parâmetros de tipo genérico do método.

bindingAttr

BindingFlags

Uma combinação bit a bit dos valores de enumeração que especificam como a pesquisa é conduzida.

-ou-

Default retornar null.

binder

Binder

Um objeto que define um conjunto de propriedades e habilita a associação, que pode envolver a seleção de um método sobrecarregado, a coerção de tipos de argumento e a invocação de um membro por meio da reflexão.

-ou-

Uma referência nula (Nothing no Visual Basic) para usar o DefaultBinder.

types

Type[]

Uma matriz de objetos Type que representam o número, a ordem e o tipo dos parâmetros a serem obtidos pelo método.

-ou-

Uma matriz vazia de objetos Type (conforme fornecido pelo campo EmptyTypes) para obter um método que não usa parâmetros.

modifiers

ParameterModifier[]

Uma matriz de objetos ParameterModifier que representam os atributos associados ao elemento correspondente na matriz types. Para ser usado somente ao chamar por meio da interoperabilidade COM, somente os parâmetros que são passados por referência são tratados. O associador padrão não processa esse parâmetro.

Retornos

MethodInfo

Um objeto que representa o método que corresponde à contagem de parâmetros genéricos, tipos de argumento, modificadores e restrições de associação especificados, se encontrado; caso contrário, null.

Exceções

ArgumentNullException

name é null.

-ou-

types é null.

-ou-

Um dos elementos na matriz types é null.

ArgumentException

genericParameterCount é negativo.

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

Origem:

Type.cs

Pesquisa o método especificado cujos parâmetros correspondem aos tipos de argumento e modificadores especificados, usando as restrições de associação especificadas.

public:
 virtual System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);

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

abstract member GetMethod : string * System.Reflection.BindingFlags * System.Reflection.Binder * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo
override this.GetMethod : string * System.Reflection.BindingFlags * System.Reflection.Binder * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo

Public Function GetMethod (name As String, bindingAttr As BindingFlags, binder As Binder, types As Type(), modifiers As ParameterModifier()) As MethodInfo

Parâmetros

name

String

A cadeia de caracteres que contém o nome do método a ser obtido.

bindingAttr

BindingFlags

Uma combinação bit a bit dos valores de enumeração que especificam como a pesquisa é conduzida.

-ou-

Default retornar null.

binder

Binder

Um objeto que define um conjunto de propriedades e habilita a associação, que pode envolver a seleção de um método sobrecarregado, a coerção de tipos de argumento e a invocação de um membro por meio da reflexão.

-ou-

Uma referência nula (Nothing no Visual Basic) para usar o DefaultBinder.

types

Type[]

Uma matriz de objetos Type que representam o número, a ordem e o tipo dos parâmetros a serem obtidos pelo método.

-ou-

Uma matriz vazia de objetos Type (conforme fornecido pelo campo EmptyTypes) para obter um método que não usa parâmetros.

modifiers

ParameterModifier[]

Uma matriz de objetos ParameterModifier que representam os atributos associados ao elemento correspondente na matriz types. Para ser usado somente ao chamar por meio da interoperabilidade COM, somente os parâmetros que são passados por referência são tratados. O associador padrão não processa esse parâmetro.

Retornos

MethodInfo

Um objeto que representa o método que corresponde aos requisitos especificados, se encontrado; caso contrário, null.

Implementações

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

Exceções

AmbiguousMatchException

Mais de um método é encontrado com o nome especificado e correspondendo às restrições de associação especificadas.

ArgumentNullException

name é null.

-ou-

types é null.

-ou-

Um dos elementos no types é null.

ArgumentException

types é multidimensional.

-ou-

modifiers é multidimensional.

Exemplos

O exemplo a seguir encontra sobrecargas específicas de MethodA, especificando restrições de associação e uma variedade de tipos de argumento.

Nota

O exemplo do Visual C# 2005 requer a opção /unsafe compilador.

using namespace System;
using namespace System::Reflection;

public ref class Program
{

public:
    // Methods to get:

    void MethodA(int i, int j) { }

    void MethodA(array<int>^ iarry) { }

    void MethodA(double *ip) { }

    // Method that takes a managed reference parameter.
    void MethodA(int% r) {}
};

int main()
{
    MethodInfo^ mInfo;


    // Get MethodA(int i, int j)
    mInfo = Program::typeid->GetMethod("MethodA",
        static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance),
        nullptr,
        gcnew array<Type^> {int::typeid, int::typeid},
        nullptr);
    Console::WriteLine("Found method: {0}", mInfo );

    // Get  MethodA(array<int>^ iarry)
    mInfo = Program::typeid->GetMethod("MethodA",
        static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance),
        nullptr,
        gcnew array<Type^> {int::typeid->MakeArrayType()},
        nullptr);
    Console::WriteLine("Found method: {0}", mInfo );

    // Get MethodA(double *ip)
    mInfo = Program::typeid->GetMethod("MethodA",
        static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance),
        nullptr,
        gcnew array<Type^> {double::typeid->MakePointerType()},
        nullptr);
    Console::WriteLine("Found method: {0}", mInfo );

    // Get MethodA(int% r)
    mInfo = Program::typeid->GetMethod("MethodA",
        static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance),
        nullptr,
        gcnew array<Type^> {int::typeid->MakeByRefType()},
        nullptr);
    Console::WriteLine("Found method: {0}", mInfo );
}

using System;
using System.Reflection;

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

open System
open System.Reflection

type Program() =
    // Methods to get:
    member _.MethodA(i: int, j: int) = ()

    member _.MethodA(i: int[]) = ()
    
    member _.MethodA(i: int nativeptr) = ()

    member _.MethodA(r: int byref) = ()

    // Method that takes an outref parameter:
    member _.MethodA(i: int, o: int outref) = o <- 100

do
    // Get MethodA(int i, int j)
    let mInfo = 
        typeof<Program>.GetMethod("MethodA",BindingFlags.Public ||| BindingFlags.Instance, null, [| typeof<int>; typeof<int> |], null)
    printfn $"Found method: {mInfo}"

    // Get MethodA(int[] i)
    let mInfo = 
        typeof<Program>.GetMethod("MethodA",BindingFlags.Public ||| BindingFlags.Instance, null, [| typeof<int[]> |], null)
    printfn $"Found method: {mInfo}"

    // Get MethodA(int* i)
    let mInfo = 
        typeof<Program>.GetMethod("MethodA",BindingFlags.Public ||| BindingFlags.Instance, null, [| typeof<int>.MakePointerType() |], null)
    printfn $"Found method: {mInfo}"

    // Get MethodA(ref int r)
    let mInfo = 
        typeof<Program>.GetMethod("MethodA",BindingFlags.Public ||| BindingFlags.Instance, null, [| typeof<int>.MakeByRefType() |], null)
    printfn $"Found method: {mInfo}"

    // Get MethodA(int i, out int o)
    let mInfo = 
        typeof<Program>.GetMethod("MethodA",BindingFlags.Public ||| BindingFlags.Instance, null, [| typeof<int>; typeof<int>.MakeByRefType() |], null)
    printfn $"Found method: {mInfo}"

Imports System.Reflection
Imports System.Runtime.InteropServices

Class Program

    ' Methods to get:
    
    Public Overloads Sub MethodA(ByVal i As Integer, ByVal l As Long)

    End Sub

    Public Overloads Sub MethodA(ByVal i() As Integer)

    End Sub

    Public Overloads Sub MethodA(ByRef r As Integer)

    End Sub

    ' Method that takes an out parameter. Note that an Imports
    ' reference is needed to System.Runtime.InteropServices 
    ' for the <OutAttribute>, which can be shortened to <Out>.
    Public Overloads Sub MethodA(ByVal i As Integer, <Out()> ByRef o As Integer)
        o = 100
    End Sub

    Public Shared Sub Main(ByVal args() As String)
        Dim mInfo As MethodInfo

        ' Get MethodA(ByVal i As Integer, ByVal l As Long)
        mInfo = GetType(Program).GetMethod("MethodA", _
            BindingFlags.Public Or BindingFlags.Instance, _
            Nothing, _
            New Type() {GetType(System.Int32), _
            GetType(System.Int64)}, _
            Nothing)
        Console.WriteLine("Found method: {0}", mInfo)

        ' Get MethodA(ByVal i() As Integer)
        mInfo = GetType(Program).GetMethod("MethodA", _
            BindingFlags.Public Or BindingFlags.Instance, _
            Nothing, _
            New Type() {GetType(System.Int32())}, _
            Nothing)
        Console.WriteLine("Found method: {0}", mInfo)

        ' Get MethodA(ByRef r As Integer)
        mInfo = GetType(Program).GetMethod("MethodA", _
            BindingFlags.Public Or BindingFlags.Instance, _
            Nothing, _
            New Type() {GetType(System.Int32).MakeByRefType}, _
            Nothing)
        Console.WriteLine("Found method: {0}", mInfo)

        ' Get MethodA(ByVal i As Integer, <Out()> ByRef o As Integer)
        mInfo = GetType(Program).GetMethod("MethodA", _
            BindingFlags.Public Or BindingFlags.Instance, _
            Nothing, _
            New Type() {GetType(System.Int32), GetType(System.Int32).MakeByRefType}, _
            Nothing)
        Console.WriteLine("Found method: {0}", mInfo)

    End Sub
End Class

Comentários

Embora o associador padrão não processe ParameterModifier (o parâmetro modifiers), você pode usar a classe System.Reflection.Binder abstrata para escrever um associador personalizado que processa modifiers. ParameterModifier só é usado ao chamar por meio da interoperabilidade COM e somente os parâmetros que são passados por referência são tratados.

Os seguintes sinalizadores de filtro de BindingFlags podem ser usados para definir quais métodos incluir na pesquisa:

• Você deve especificar BindingFlags.Instance ou BindingFlags.Static para obter um retorno.

• Especifique BindingFlags.Public para incluir métodos públicos na pesquisa.

• Especifique BindingFlags.NonPublic para incluir métodos não públicos (ou seja, métodos privados, internos e protegidos) na pesquisa.

• Especifique BindingFlags.FlattenHierarchy para incluir membros estáticos public e protected na hierarquia; private membros estáticos em classes herdadas não estão incluídos.

Os seguintes sinalizadores modificador de BindingFlags podem ser usados para alterar o funcionamento da pesquisa:

• BindingFlags.IgnoreCase ignorar o caso de name.

• BindingFlags.DeclaredOnly pesquisar apenas os métodos declarados no Type, não os métodos que foram simplesmente herdados.

Consulte System.Reflection.BindingFlags para obter mais informações.

Nota

Você não pode omitir parâmetros ao procurar construtores e métodos. Você só pode omitir parâmetros ao invocar.

Se o Type atual representar um tipo genérico construído, esse método retornará o MethodInfo com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.

Se o Type atual representar um parâmetro de tipo na definição de um tipo genérico ou método genérico, esse método pesquisará os métodos da restrição de classe ou os métodos de Object se não houver nenhuma restrição de classe.

Nota

Para métodos genéricos, não inclua os argumentos de tipo em name. Por exemplo, o código C# GetMember("MyMethod<int>") pesquisa um membro com o nome de texto "MyMethod<int>", em vez de um método chamado MyMethod que tem um argumento genérico do tipo int.

Confira também

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

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

Origem:

Type.cs

Pesquisa o método público especificado cujos parâmetros correspondem à contagem de parâmetros genéricos, tipos de argumento e modificadores especificados.

public:
 System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, int genericParameterCount, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);

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

member this.GetMethod : string * int * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo

Public Function GetMethod (name As String, genericParameterCount As Integer, types As Type(), modifiers As ParameterModifier()) As MethodInfo

Parâmetros

name

String

A cadeia de caracteres que contém o nome do método público a ser obtido.

genericParameterCount

Int32

O número de parâmetros de tipo genérico do método.

types

Type[]

Uma matriz de objetos Type que representam o número, a ordem e o tipo dos parâmetros a serem obtidos pelo método.

-ou-

Uma matriz vazia de objetos Type (conforme fornecido pelo campo EmptyTypes) para obter um método que não usa parâmetros.

modifiers

ParameterModifier[]

Uma matriz de objetos ParameterModifier que representam os atributos associados ao elemento correspondente na matriz types. Para ser usado somente ao chamar por meio da interoperabilidade COM, somente os parâmetros que são passados por referência são tratados. O associador padrão não processa esse parâmetro.

Retornos

MethodInfo

Um objeto que representa o método público que corresponde à contagem de parâmetros genéricos, tipos de argumento e modificadores especificados, se encontrado; caso contrário, null.

Exceções

ArgumentNullException

name é null.

-ou-

types é null.

-ou-

Um dos elementos na matriz types é null.

ArgumentException

genericParameterCount é negativo.

GetMethod(String, BindingFlags)

Origem:

Type.cs

Pesquisa o método especificado usando as restrições de associação especificadas.

public:
 virtual System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, System::Reflection::BindingFlags bindingAttr);

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

abstract member GetMethod : string * System.Reflection.BindingFlags -> System.Reflection.MethodInfo
override this.GetMethod : string * System.Reflection.BindingFlags -> System.Reflection.MethodInfo

Public Function GetMethod (name As String, bindingAttr As BindingFlags) As MethodInfo

Parâmetros

name

String

A cadeia de caracteres que contém o nome do método a ser obtido.

bindingAttr

BindingFlags

Uma combinação bit a bit dos valores de enumeração que especificam como a pesquisa é conduzida.

-ou-

Default retornar null.

Retornos

MethodInfo

Um objeto que representa o método que corresponde aos requisitos especificados, se encontrado; caso contrário, null.

Implementações

GetMethod(String, BindingFlags)

Exceções

AmbiguousMatchException

Mais de um método é encontrado com o nome especificado e correspondendo às restrições de associação especificadas.

ArgumentNullException

name é null.

Exemplos

O exemplo a seguir obtém o método que corresponde aos sinalizadores de associação especificados.

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

    public:

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

    };

    int main()
    {

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

    }

using System;
using System.Reflection;

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

open System.Reflection

type Program() =
    // Method to get:
    member _.MethodA() = ()

// Get MethodA()
let mInfo = typeof<Program>.GetMethod("MethodA", BindingFlags.Public ||| BindingFlags.Instance)
printfn $"Found method: {mInfo}"

Imports System.Reflection

Class Program

    ' Method to get:
    Public Sub MethodA()
    End Sub


    Public Shared Sub Main(ByVal args() As String)

        ' Get MethodA()
        Dim mInfo As MethodInfo = GetType(Program).GetMethod("MethodA", _
            BindingFlags.Public Or BindingFlags.Instance)
        Console.WriteLine("Found method: {0}", mInfo)

    End Sub
End Class

Comentários

Os seguintes sinalizadores de filtro de BindingFlags podem ser usados para definir quais métodos incluir na pesquisa:

• Você deve especificar BindingFlags.Instance ou BindingFlags.Static para obter um retorno.

• Especifique BindingFlags.Public para incluir métodos públicos na pesquisa.

• Especifique BindingFlags.NonPublic para incluir métodos não públicos (ou seja, métodos privados, internos e protegidos) na pesquisa.

• Especifique BindingFlags.FlattenHierarchy para incluir membros estáticos public e protected na hierarquia; private membros estáticos em classes herdadas não estão incluídos.

Os seguintes sinalizadores modificador de BindingFlags podem ser usados para alterar o funcionamento da pesquisa:

• BindingFlags.IgnoreCase ignorar o caso de name.

• BindingFlags.DeclaredOnly pesquisar apenas os métodos declarados no Type, não os métodos que foram simplesmente herdados.

Consulte System.Reflection.BindingFlags para obter mais informações.

Se um método estiver sobrecarregado e mais de uma sobrecarga atender às restrições especificadas pelo argumento bindingAttr, o método gerará uma exceção AmbiguousMatchException. No exemplo a seguir, uma exceção é gerada porque:

• O tipo TestClass tem duas sobrecargas de instância pública do método DisplayValue, DisplayValue(String) e DisplayValue(String, Object[]).

• O tipo TestClass tem duas sobrecargas de instância pública do método Equals, uma das quais é herdada de Object: Equals(TestClass) e 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)

open System
open System.Reflection

type TestClass() =
    member _.DisplayValue(s) = 
        printfn $"%s{s}"

    member _.DisplayValue(s: string, [<ParamArray>]values: obj[]) =
        Console.WriteLine(s, values)

    member this.Equals(t: TestClass) =
        Object.ReferenceEquals(this, t)

    static member Equals(t1: TestClass, t2: TestClass) =
        Object.ReferenceEquals(t1, t2)

let retrieveMethod (t: Type) name (flags: BindingFlags) =
    try
        let m = t.GetMethod(name, flags)
        if m <> null then
            printf $"{t.Name}.{m.Name}("
            let parms = m.GetParameters()
            for i = 0 to parms.Length - 1 do
                printf $"{parms[i].ParameterType.Name}"
                if i < parms.Length - 1 then
                    printf ", "
            printfn ")"
        else
            printfn "Method not found"
    with :? AmbiguousMatchException ->
        printfn "The following duplicate matches were found:"
        let methods = t.GetMethods flags
        for method in methods do
            if method.Name = name then
                printf $"   {t.Name}.{method.Name}("
                let parms = method.GetParameters()
                for i = 0 to parms.Length - 1 do
                    printf $"{parms[i].ParameterType.Name}"
                    if i < parms.Length - 1 then
                        printf ", "
                printfn ")"
    printfn ""

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

// The example displays the following output:
//       The following duplicate matches were found:
//          TestClass.DisplayValue(String)
//          TestClass.DisplayValue(String, Object[])
//       
//       The following duplicate matches were found:
//          TestClass.Equals(TestClass)
//          TestClass.Equals(Object)
//       
//       TestClass.Equals(TestClass)
//       
//       TestClass.Equals(TestClass, TestClass)

Imports System.Reflection

Public Class TestClass
   Public Sub DisplayValue(s As String)
      Console.WriteLine(s)
   End Sub
   
   Public Sub DisplayValue(s As String, ParamArray values() As Object)
      Console.WriteLine(s, values)
   End Sub
   
   Public Overloads Shared Function Equals(t1 As TestClass, t2 As TestClass) As Boolean
      Return Object.ReferenceEquals(t1, t2)
   End Function
   
   Public Overloads Function Equals(t As TestClass) As Boolean
      Return Object.ReferenceEquals(Me, t)
   End Function          
End Class

Module Example
   Public Sub Main()
      Dim t As Type = GetType(TestClass)
      
      RetrieveMethod(t, "DisplayValue", BindingFlags.Public Or BindingFlags.Instance)

      RetrieveMethod(t, "Equals", BindingFlags.Public Or BindingFlags.Instance)
      
      RetrieveMethod(t, "Equals", BindingFlags.Public Or BindingFlags.Instance Or BindingFlags.DeclaredOnly)
      
      RetrieveMethod(t, "Equals", BindingFlags.Public Or BindingFlags.Static)
   End Sub
   
   Public Sub RetrieveMethod(t As Type, name As String, flags As BindingFlags)
      Try
         Dim m As MethodInfo = t.GetMethod(name, flags)
         If m IsNot Nothing Then
            Console.Write("{0}.{1}(", t.Name, m.Name)
           Dim parms() As ParameterInfo = m.GetParameters()
            For ctr As Integer = 0 To parms.Length - 1
               Console.Write(parms(ctr).ParameterType.Name)
               if ctr < parms.Length - 1 Then 
                  Console.Write(", ")
               End If      
            Next
            Console.WriteLine(")")
         Else
            Console.WriteLine("Method not found")
         End If
      Catch e As AmbiguousMatchException
         Console.WriteLine("The following duplicate matches were found:")
         Dim methods() As MethodInfo = t.GetMethods(flags)
         For Each method In methods
            If method.Name <> name Then Continue For

            Console.Write("   {0}.{1}(", t.Name, method.Name)
            Dim parms() As ParameterInfo = method.GetParameters()
            For ctr As Integer = 0 To parms.Length - 1
               Console.Write(parms(ctr).ParameterType.Name)
               if ctr < parms.Length - 1 Then 
                  Console.Write(", ")
               End If      
            Next
            Console.WriteLine(")")
         Next 
      End Try         
      Console.WriteLine()
   End Sub
End Module
' The example displays the following output:
'       The following duplicate matches were found:
'          TestClass.DisplayValue(String)
'          TestClass.DisplayValue(String, Object[])
'       
'       The following duplicate matches were found:
'          TestClass.Equals(TestClass)
'          TestClass.Equals(Object)
'       
'       TestClass.Equals(TestClass)
'       
'       TestClass.Equals(TestClass, TestClass)

Você pode fazer um dos seguintes procedimentos para recuperar um método específico:

• Altere as restrições de associação. No exemplo anterior, tentar recuperar uma instância pública Equals método que é declarado pelo tipo e não herdado recupera com êxito Equals(TestClass).

• Chame uma sobrecarga do método GetMethod que inclui um parâmetro types que define os tipos de parâmetros do método.

• Chame o método GetMethods(BindingFlags) para recuperar uma matriz que contém todos os métodos pertencentes a um tipo que tenha os atributos de associação especificados. Em seguida, você pode iterá-lo para identificar os métodos duplicados chamados name. Essa abordagem é ilustrada no manipulador do exemplo anterior para a exceção AmbiguousMatchException.

Se o Type atual representar um tipo genérico construído, esse método retornará o MethodInfo com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.

Se o Type atual representar um parâmetro de tipo na definição de um tipo genérico ou método genérico, esse método pesquisará os métodos da restrição de classe ou os métodos de Object se não houver nenhuma restrição de classe.

Nota

Para métodos genéricos, não inclua os argumentos de tipo em name. Por exemplo, o código C# GetMember("MyMethod<int>") pesquisa um membro com o nome de texto "MyMethod<int>", em vez de um método chamado MyMethod que tem um argumento genérico do tipo int.

Confira também

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

GetMethod(String, BindingFlags, Type[])

Origem:

Type.cs

Pesquisa o método especificado cujos parâmetros correspondem aos tipos de argumento especificados, usando as restrições de associação especificadas.

public:
 System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, System::Reflection::BindingFlags bindingAttr, cli::array <Type ^> ^ types);

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

member this.GetMethod : string * System.Reflection.BindingFlags * Type[] -> System.Reflection.MethodInfo

Public Function GetMethod (name As String, bindingAttr As BindingFlags, types As Type()) As MethodInfo

Parâmetros

name

String

A cadeia de caracteres que contém o nome do método a ser obtido.

bindingAttr

BindingFlags

Uma combinação bit a bit dos valores de enumeração que especificam como a pesquisa é conduzida. -ou- Padrão para retornar null.

types

Type[]

Uma matriz de objetos Type que representam o número, a ordem e o tipo dos parâmetros a serem obtidos pelo método. -ou- Uma matriz vazia de objetos Type (conforme fornecido pelo campo EmptyTypes) para obter um método que não usa parâmetros.

Retornos

MethodInfo

Um objeto que representa o método que corresponde aos requisitos especificados, se encontrado; caso contrário, null.

GetMethod(String, Int32, Type[])

Origem:

Type.cs

Pesquisa o método público especificado cujos parâmetros correspondem aos tipos de argumento e contagem de parâmetros genéricos especificados.

public:
 System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, int genericParameterCount, cli::array <Type ^> ^ types);

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

member this.GetMethod : string * int * Type[] -> System.Reflection.MethodInfo

Public Function GetMethod (name As String, genericParameterCount As Integer, types As Type()) As MethodInfo

Parâmetros

name

String

A cadeia de caracteres que contém o nome do método público a ser obtido.

genericParameterCount

Int32

O número de parâmetros de tipo genérico do método.

types

Type[]

Uma matriz de objetos Type que representam o número, a ordem e o tipo dos parâmetros a serem obtidos pelo método.

-ou-

Uma matriz vazia de objetos Type (conforme fornecido pelo campo EmptyTypes) para obter um método que não usa parâmetros.

Retornos

MethodInfo

Um objeto que representa o método público cujos parâmetros correspondem aos tipos de argumento e contagem de parâmetros genéricos especificados, se encontrado; caso contrário, null.

Exceções

ArgumentNullException

name é null.

-ou-

types é null.

-ou-

Um dos elementos na matriz types é null.

ArgumentException

genericParameterCount é negativo.

GetMethod(String, Type[])

Origem:

Type.cs

Pesquisa o método público especificado cujos parâmetros correspondem aos tipos de argumento especificados.

public:
 System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, cli::array <Type ^> ^ types);

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

member this.GetMethod : string * Type[] -> System.Reflection.MethodInfo

Public Function GetMethod (name As String, types As Type()) As MethodInfo

Parâmetros

name

String

A cadeia de caracteres que contém o nome do método público a ser obtido.

types

Type[]

Uma matriz de objetos Type que representam o número, a ordem e o tipo dos parâmetros a serem obtidos pelo método.

-ou-

Uma matriz vazia de objetos Type (conforme fornecido pelo campo EmptyTypes) para obter um método que não usa parâmetros.

Retornos

MethodInfo

Um objeto que representa o método público cujos parâmetros correspondem aos tipos de argumento especificados, se encontrado; caso contrário, null.

Exceções

AmbiguousMatchException

Mais de um método é encontrado com o nome especificado e os parâmetros especificados.

ArgumentNullException

name é null.

-ou-

types é null.

-ou-

Um dos elementos no types é null.

ArgumentException

types é multidimensional.

Exemplos

O exemplo a seguir encontra sobrecargas específicas de MethodA, especificando uma variedade de tipos de argumento.

Nota

O exemplo do Visual C# 2005 requer a opção /unsafe compilador.

using namespace System;
using namespace System::Reflection;

public ref class Program
{

public:
    // Methods to get:

    void MethodA(int i, int j) { }

    void MethodA(array<int>^ iarry) { }

    void MethodA(double *ip) { }

    // Method that takes a managed reference parameter.
    void MethodA(int% r) {}
};

int main()
{
    MethodInfo^ mInfo;


    // Get MethodA(int i, int j)
    mInfo = Program::typeid->GetMethod("MethodA", gcnew array<Type^> {int::typeid,int::typeid});
    Console::WriteLine("Found method: {0}", mInfo );

    // Get MethodA(array<int>^ iarry)
    mInfo = Program::typeid->GetMethod("MethodA", gcnew array<Type^> {int::typeid->MakeArrayType()});
    Console::WriteLine("Found method: {0}", mInfo );

    // Get MethodA(double *ip)
    mInfo = Program::typeid->GetMethod("MethodA", gcnew array<Type^> {double::typeid->MakePointerType()});
    Console::WriteLine("Found method: {0}", mInfo );

    // Get MethodA(int% r)
    mInfo = Program::typeid->GetMethod("MethodA", gcnew array<Type^> {int::typeid->MakeByRefType()});
    // Display the method information.
    Console::WriteLine("Found method: {0}", mInfo );

}

using System;
using System.Reflection;

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

type Program() =
    // Methods to get:
    member _.MethodA(i: int, j: int) = ()

    member _.MethodA(i: int[]) = ()
    
    member _.MethodA(i: int nativeptr) = ()

    member _.MethodA(r: int byref) = ()

    // Method that takes an outref parameter:
    member _.MethodA(i: int, o: int outref) = o <- 100

do
    // member MethodA: i: int * j: int -> unit
    let mInfo = typeof<Program>.GetMethod("MethodA", [| typeof<int>; typeof<int> |])
    printfn $"Found method: {mInfo}"

    // member MethodA: i: int[] -> unit
    let mInfo = typeof<Program>.GetMethod("MethodA", [| typeof<int[]> |])
    printfn $"Found method: {mInfo}"

    // member MethodA: i: nativeptr<int> -> unit
    let mInfo = typeof<Program>.GetMethod("MethodA", [| typeof<int>.MakePointerType() |])
    printfn $"Found method: {mInfo}"

    // member MethodA: r: byref<int> -> unit
    let mInfo = typeof<Program>.GetMethod("MethodA", [| typeof<int>.MakeByRefType() |])
    printfn $"Found method: {mInfo}"

    // member MethodA: i: int * o: outref<int> -> unit
    let mInfo = typeof<Program>.GetMethod("MethodA", [| typeof<int>; typeof<int>.MakeByRefType() |])
    printfn $"Found method: {mInfo}"

Imports System.Reflection
Imports System.Runtime.InteropServices

Class Program

    ' Methods to get:

    Public Overloads Sub MethodA(ByVal i As Integer, ByVal l As Long)

    End Sub

    Public Overloads Sub MethodA(ByVal i() As Integer)

    End Sub

    Public Overloads Sub MethodA(ByRef r As Integer)

    End Sub

    ' Method that takes an out parameter. Note that an Imports
    ' reference is needed to System.Runtime.InteropServices 
    ' for the <OutAttribute>, which can be shortened to <Out>.
    Public Overloads Sub MethodA(ByVal i As Integer, <Out()> ByRef o As Integer)
        o = 100
    End Sub

    Public Shared Sub Main(ByVal args() As String)
        Dim mInfo As MethodInfo

        ' Get MethodA(i As Integer i, l As Long)
        mInfo = GetType(Program).GetMethod("MethodA", New Type() {GetType(Integer), GetType(Long)})
        Console.WriteLine("Found method: {0}", mInfo)

        ' Get  MethodA(i As Integer())
        mInfo = GetType(Program).GetMethod("MethodA", New Type() {GetType(Integer())})
        Console.WriteLine("Found method: {0}", mInfo)

        ' Get MethodA(ByRef r As Integer)
        mInfo = GetType(Program).GetMethod("MethodA", New Type() {GetType(Integer).MakeByRefType})
        Console.WriteLine("Found method: {0}", mInfo)

        ' Get MethodA(i As Integer, ByRef r As Integer)
        mInfo = GetType(Program).GetMethod("MethodA", New Type() {GetType(Integer), _
            GetType(Integer).MakeByRefType})
        Console.WriteLine("Found method: {0}", mInfo)

    End Sub
End Class

O exemplo a seguir recupera MethodInfo objetos que representam os métodos Add de um tipo não genérico (a classe ArrayList), um tipo genérico aberto (a classe List<T>) e um tipo genérico fechado (o tipo 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)

open System
open System.Collections

let getAddMethod (typ: Type) = 
    let method = 
        // Determine if this is a generic type.
        if typ.IsGenericType then
            // Is it an open generic type?
            if typ.ContainsGenericParameters then
                typ.GetMethod("Add", typ.GetGenericArguments())
            // Get closed generic type arguments.
            else
                typ.GetMethod("Add", typ.GenericTypeArguments)
        // This is not a generic type.
        else
            typ.GetMethod("Add", [| typeof<obj> |])

    // Test if an Add method was found.
    if method = null then
        printfn "No Add method found."
    else
        let t = method.ReflectedType
        printf $"{t.Namespace}.{t.Name}.{method.Name}("
        let parms = method.GetParameters()
        for i = 0 to parms.Length - 1 do
            printf $"""{parms[i].ParameterType.Name}{if i < parms.Length - 1 then ", " else ""}"""
        printfn ")"

// Get a Type object that represents a non-generic type.
getAddMethod typeof<ArrayList>

let list = ResizeArray<String>()
// Get a Type object that represents a constructed generic type.
let closed = list.GetType()
getAddMethod closed

// Get a Type object that represents an open generic type.
let opn = typeof<ResizeArray<_>>.GetGenericTypeDefinition()
getAddMethod opn

// The example displays the following output:
//       System.Collections.ArrayList.Add(Object)
//       System.Collections.Generic.List`1.Add(String)
//       System.Collections.Generic.List`1.Add(T)

Imports System.Collections
Imports System.Collections.Generic
Imports System.Reflection

Module Example
   Public Sub Main()
      ' Get a Type object that represents a non-generic type.
      GetAddMethod(GetType(ArrayList))
      
      Dim list As New List(Of String)()
      ' Get a Type object that represents a constructed generic type.
      Dim closed As Type = list.GetType()
      GetAddMethod(closed)
      
      ' Get a Type object that represents an open generic type.
      Dim open As Type = GetType(List(Of))
      GetAddMethod(open)
   End Sub
   
   Private Sub GetAddMethod(typ As Type)
      Dim method As MethodInfo
      ' Determine if this is a generic type.
      If typ.IsGenericType Then
         ' Is it an open generic type?
         If typ.ContainsGenericParameters Then
            method = typ.GetMethod("Add", typ.GetGenericArguments())
         ' Get closed generic type arguments.
         Else
            method = typ.GetMethod("Add", typ.GenericTypeArguments)
         End If
      ' This is not a generic type.
      Else
         method = typ.GetMethod("Add", { GetType(Object) } )
      End If
      ' Test if an Add method was found.
      If method Is Nothing Then 
         Console.WriteLine("No Add method found.")
         Exit Sub
      End If   

      Dim t As Type = method.ReflectedType
      Console.Write("{0}.{1}.{2}(", t.Namespace, t.Name, method.Name)
      Dim params() As ParameterInfo = method.GetParameters()
      For ctr As Integer = 0 To params.Length - 1
         Console.Write("{0}{1}", params(ctr).ParameterType.Name, 
                       If(ctr < params.Length - 1, ", ", ""))
      Next
      Console.WriteLine(")")
   End Sub
End Module
' The example displays the following output:
'       System.Collections.ArrayList.Add(Object)
'       System.Collections.Generic.List`1.Add(String)
'       System.Collections.Generic.List`1.Add(T)

O exemplo define um método GetAddMethod que recupera o objeto MethodInfo apropriado. Para fornecer o argumento types para um tipo genérico aberto, ele chama o método Type.GetGenericArguments. Para fornecer o argumento types para um tipo genérico fechado, ele recupera o valor da propriedade Type.GenericTypeArguments.

Comentários

A pesquisa por name diferencia maiúsculas de minúsculas. A pesquisa inclui métodos de instância pública e estática pública.

Nota

Você não pode omitir parâmetros ao procurar construtores e métodos. Você só pode omitir parâmetros ao invocar.

Se o Type atual representar um tipo genérico construído, esse método retornará o MethodInfo com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.

Se o Type atual representar um parâmetro de tipo na definição de um tipo genérico ou método genérico, esse método pesquisará os métodos da restrição de classe ou os métodos de Object se não houver nenhuma restrição de classe.

Nota

O parâmetro name não pode incluir argumentos de tipo. Por exemplo, o código C# GetMethod("MyGenericMethod<int>") pesquisa um método com o nome de texto "MyGenericMethod<int>", em vez de um método chamado MyGenericMethod que tem um argumento genérico do tipo int. Em vez disso, use GetMethod("MyGenericMethod") com o parâmetro apropriado na matriz types.

Confira também

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

GetMethod(String)

Origem:

Type.cs

Pesquisa o método público com o nome especificado.

public:
 System::Reflection::MethodInfo ^ GetMethod(System::String ^ name);

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

member this.GetMethod : string -> System.Reflection.MethodInfo

Public Function GetMethod (name As String) As MethodInfo

Parâmetros

name

String

A cadeia de caracteres que contém o nome do método público a ser obtido.

Retornos

MethodInfo

Um objeto que representa o método público com o nome especificado, se encontrado; caso contrário, null.

Exceções

AmbiguousMatchException

Mais de um método é encontrado com o nome especificado.

ArgumentNullException

name é null.

Exemplos

O exemplo a seguir obtém um método chamado MethodA.

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

    public:

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

    };

    int main()
    {

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

    }

using System;
using System.Reflection;

class Program
{

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

    static void Main(string[] args)
    {

        // Get MethodA()
        MethodInfo mInfo = typeof(Program).GetMethod("MethodA");
        Console.WriteLine("Found method: {0}", mInfo);
    }
}

type Program() =
    // Method to get:
    member _.MethodA() = ()

// Get MethodA()
let mInfo = typeof<Program>.GetMethod "MethodA"
printfn $"Found method: {mInfo}"

Imports System.Reflection

Class Program

    ' Method to get:
    Public Sub MethodA()
    End Sub


    Public Shared Sub Main(ByVal args() As String)

        ' Get MethodA()
        Dim mInfo As MethodInfo = GetType(Program).GetMethod("MethodA")
        Console.WriteLine("Found method: {0}", mInfo)

    End Sub
End Class

Comentários

A pesquisa por name diferencia maiúsculas de minúsculas. A pesquisa inclui métodos de instância pública e estática pública.

Se um método estiver sobrecarregado e tiver mais de um método público, o método GetMethod(String) gerará uma exceção AmbiguousMatchException. No exemplo a seguir, uma exceção é gerada porque há mais de uma sobrecarga pública do método Int32.ToString. Por outro lado, como o método Person.ToString substitui Object.ToString e, portanto, não é sobrecarregado, o método GetMethod(String) é capaz de recuperar o objeto 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.

open System
open System.Reflection

type Person() =
    member val FirstName = "" with get, set
    member val LastName = "" with get, set

    override this.ToString() =
        (this.FirstName + " " + this.LastName).Trim()

let retrieveMethod (t: Type) name =
    try
        let m = t.GetMethod name
        if m <> null then
            printfn $"""{m.ReflectedType.Name}.{m.Name}: {if m.IsStatic then "Static" else "Instance"} method"""
        else
            printfn $"{t.Name}.ToString method not found"
    with :? AmbiguousMatchException ->
        printfn $"{t.Name}.{name} has multiple public overloads."

let t = typeof<Person>
retrieveMethod t "ToString"

let t2 = typeof<int>
retrieveMethod t2 "ToString"

// The example displays the following output:
//       Person.ToString: Instance method
//       Int32.ToString has multiple public overloads.

Imports System.Reflection

Public Class Person
   Public FirstName As String
   Public LastName As String
   
   Public Overrides Function ToString() As String
      Return (FirstName + " " + LastName).Trim()
   End Function
End Class

Module Example
   Public Sub Main()
      Dim t As Type = GetType(Person)
      RetrieveMethod(t, "ToString")
      
      t = GetType(Int32)
      RetrieveMethod(t, "ToString")
   End Sub
   
   Private Sub RetrieveMethod(t As Type, name As String)   
      Try
         Dim m As MethodInfo = t.GetMethod(name)
         If m IsNot Nothing Then
            Console.WriteLine("{0}.{1}: {2} method", m.ReflectedType.Name,
                              m.Name, If(m.IsStatic, "Static", "Instance"))    
         Else
            Console.WriteLine("{0}.ToString method not found", t.Name)
         End If   
      Catch e As AmbiguousMatchException
         Console.WriteLine("{0}.{1} has multiple public overloads.", 
                           t.Name, name)
      End Try
   End Sub
End Module
' The example displays the following output:
'       Person.ToString: Instance method
'       Int32.ToString has multiple public overloads.

Você pode fazer um dos seguintes procedimentos para recuperar um método específico:

• Chame o método GetMethod(String, BindingFlags) e especifique um argumento bindingAttr que identifique exclusivamente o método. Por exemplo, se a exceção for gerada porque um tipo tem uma sobrecarga estática e de instância, você pode especificar um argumento bindingAttr de BindingFlags.InstanceOrBindingFlags.Instance.

• Chame uma sobrecarga do método GetMethod que inclui um parâmetro types que define os tipos de parâmetros do método.

• Chame o método GetMethods() para recuperar uma matriz que contém todos os métodos públicos pertencentes a um tipo. Em seguida, você pode iterá-lo para identificar os métodos duplicados chamados name.

Se o Type atual representar um tipo genérico construído, esse método retornará o MethodInfo com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.

Se o Type atual representar um parâmetro de tipo na definição de um tipo genérico ou método genérico, esse método pesquisará os métodos da restrição de classe ou os métodos de Object se não houver nenhuma restrição de classe.

Nota

Para métodos genéricos, não inclua os argumentos de tipo em name. Por exemplo, o código C# GetMember("MyMethod<int>") pesquisa um membro com o nome de texto "MyMethod<int>", em vez de um método chamado MyMethod que tem um argumento genérico do tipo int.

Confira também

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

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

Origem:

Type.cs

Pesquisa o método público especificado cujos parâmetros correspondem aos tipos de argumento e modificadores especificados.

public:
 System::Reflection::MethodInfo ^ GetMethod(System::String ^ name, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);

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

member this.GetMethod : string * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.MethodInfo

Public Function GetMethod (name As String, types As Type(), modifiers As ParameterModifier()) As MethodInfo

Parâmetros

name

String

A cadeia de caracteres que contém o nome do método público a ser obtido.

types

Type[]

Uma matriz de objetos Type que representam o número, a ordem e o tipo dos parâmetros a serem obtidos pelo método.

-ou-

Uma matriz vazia de objetos Type (conforme fornecido pelo campo EmptyTypes) para obter um método que não usa parâmetros.

modifiers

ParameterModifier[]

Uma matriz de objetos ParameterModifier que representam os atributos associados ao elemento correspondente na matriz types. Para ser usado somente ao chamar por meio da interoperabilidade COM, somente os parâmetros que são passados por referência são tratados. O associador padrão não processa esse parâmetro.

Retornos

MethodInfo

Um objeto que representa o método público que corresponde aos requisitos especificados, se encontrado; caso contrário, null.

Exceções

AmbiguousMatchException

Mais de um método é encontrado com o nome especificado e os parâmetros especificados.

ArgumentNullException

name é null.

-ou-

types é null.

-ou-

Um dos elementos no types é null.

ArgumentException

types é multidimensional.

-ou-

modifiers é multidimensional.

Comentários

Embora o associador padrão não processe ParameterModifier (o parâmetro modifiers), você pode usar a classe System.Reflection.Binder abstrata para escrever um associador personalizado que processa modifiers. ParameterModifier só é usado ao chamar por meio da interoperabilidade COM e somente os parâmetros que são passados por referência são tratados.

A pesquisa por name diferencia maiúsculas de minúsculas. A pesquisa inclui métodos de instância pública e estática pública.

Nota

Você não pode omitir parâmetros ao procurar construtores e métodos. Você só pode omitir parâmetros ao invocar.

Se o Type atual representar um tipo genérico construído, esse método retornará o MethodInfo com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.

Se o Type atual representar um parâmetro de tipo na definição de um tipo genérico ou método genérico, esse método pesquisará os métodos da restrição de classe ou os métodos de Object se não houver nenhuma restrição de classe.

Nota

Para métodos genéricos, não inclua os argumentos de tipo em name. Por exemplo, o código C# GetMethod("MyMethod<int>") pesquisa um membro com o nome de texto "MyMethod<int>", em vez de um método chamado MyMethod que tem um argumento genérico do tipo int. Em vez disso, use GetMethod("MyMethod") com o parâmetro apropriado na matriz types.

Confira também

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