Type.GetMethods Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém os métodos da corrente Type.
Sobrecargas
| Name | Description |
|---|---|
| GetMethods() |
Devolve todos os métodos públicos do atual Type. |
| GetMethods(BindingFlags) |
Quando sobrescrito numa classe derivada, procura os métodos definidos para a corrente Type, usando as restrições de ligação especificadas. |
GetMethods()
Devolve todos os métodos públicos do atual Type.
public:
virtual cli::array <System::Reflection::MethodInfo ^> ^ GetMethods();
public:
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[]
member this.GetMethods : unit -> System.Reflection.MethodInfo[]
Public Function GetMethods () As MethodInfo()
Devoluções
Um array de MethodInfo objetos que representa todos os métodos públicos definidos para o atual Type.
-ou-
Um array vazio do tipo MethodInfo, se não forem definidos métodos públicos para a corrente Type.
Implementações
Observações
Em versões .NET 6 e anteriores, o método GetMethods não devolve métodos numa ordem específica, como ordem alfabética ou de declaração. O seu código não deve depender da ordem em que os métodos são devolvidos, porque essa ordem varia. No entanto, a partir do .NET 7, a ordenação é determinística com base na ordenação dos metadados na assembleia.
Os construtores não são incluídos no conjunto de métodos devolvidos por esta chamada. Faça uma chamada separada para GetConstructors() obter os métodos construtores.
A tabela a seguir mostra quais membros de uma classe base são retornados pelos Get métodos ao refletir sobre um tipo.
| Tipo de Membro | Estático | Não-estático |
|---|---|---|
| Construtor | No | No |
| Campo | No | Yes. Um campo é sempre ocultado com base no nome e assinatura. |
| Event | Não aplicável | A regra comum do sistema de tipos é que a herança é a mesma dos métodos que implementam a propriedade. A reflexão trata propriedades como esconder pelo nome e assinatura. Veja a nota 2 abaixo. |
| Método | No | Yes. Um método (virtual e não virtual) pode ser ocultado por nome ou ocultado por nome e assinatura. |
| Tipo aninhado | No | No |
| Property | Não aplicável | A regra comum do sistema de tipos é que a herança é a mesma dos métodos que implementam a propriedade. A reflexão trata propriedades como esconder pelo nome e assinatura. Veja a nota 2 abaixo. |
Ocultar por nome e assinatura considera todas as partes da assinatura, incluindo modificadores personalizados, tipos de retorno, tipos de parâmetros, sentinelas e convenções de chamada não gerenciadas. Esta é uma comparação binária.
Para reflexão, as propriedades e os eventos são ocultados por nome e assinatura. Se você tiver uma propriedade com um acessador get e um set na classe base, mas a classe derivada tiver apenas um acessor get, a propriedade de classe derivada ocultará a propriedade de classe base e você não poderá acessar o setter na classe base.
Os atributos personalizados não fazem parte do sistema de tipo comum.
Note
Não podes omitir parâmetros ao procurar construtores e métodos. Só podes omitir parâmetros ao invocar.
Se a corrente Type representa um tipo genérico construído, este método devolve os MethodInfo objetos com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.
Se a corrente Type representa um parâmetro de tipo na definição de um tipo genérico ou método genérico, este método pesquisa os métodos da restrição de classe, ou os métodos de Object se não houver restrição de classe.
Ver também
Aplica-se a
GetMethods(BindingFlags)
Quando sobrescrito numa classe derivada, procura os métodos definidos para a corrente Type, usando as restrições de ligação especificadas.
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()
Parâmetros
- bindingAttr
- BindingFlags
Uma combinação bit a bit dos valores de enumeração que especifica como a pesquisa é realizada.
-ou-
Default para devolver um array vazio.
Devoluções
Um array de MethodInfo objetos que representa todos os métodos definidos para a corrente Type que correspondem às restrições de ligação especificadas.
-ou-
Um array vazio do tipo MethodInfo, se não estiverem definidos métodos para o atual Type, ou se nenhum dos métodos definidos corresponder às restrições de ligação.
Implementações
Exemplos
O exemplo seguinte cria uma classe com dois métodos públicos e um método protegido, cria um Type objeto correspondente a MyTypeClass, obtém todos os métodos públicos e não públicos, e apresenta os seus nomes.
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
Observações
Para que a GetMethods(BindingFlags) sobrecarga recupere com sucesso a informação do método, o argumento bindingAttr deve incluir pelo menos um de BindingFlags.Instance e BindingFlags.Static, juntamente com pelo menos um de BindingFlags.NonPublic e BindingFlags.Public.
As seguintes BindingFlags bandeiras de filtro podem ser usadas para definir quais os métodos a incluir na pesquisa:
Especifique
BindingFlags.Instanceincluir métodos de instância.Especifique
BindingFlags.Statica inclusão de métodos estáticos.Especifique
BindingFlags.Publicincluir métodos públicos na pesquisa.Especifique
BindingFlags.NonPublicincluir métodos não públicos (ou seja, privados, internos e protegidos) na pesquisa. Apenas métodos protegidos e internos nas classes base são retornados; Métodos privados nas classes base não são devolvidos.Especifique
BindingFlags.FlattenHierarchypara incluirpubliceprotectedmembros estáticos na hierarquia;privatemembros estáticos em classes herdadas não são incluídos.Especifique
BindingFlags.Defaultsozinho para devolver um array vazio MethodInfo .
Os seguintes BindingFlags sinalizadores modificadores podem ser usados para alterar o funcionamento da pesquisa:
-
BindingFlags.DeclaredOnlypesquisar 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.
Em versões .NET 6 e anteriores, o método GetMethods não devolve métodos numa ordem específica, como ordem alfabética ou de declaração. O seu código não deve depender da ordem em que os métodos são devolvidos, porque essa ordem varia. No entanto, a partir do .NET 7, a ordenação é determinística com base na ordenação dos metadados na assembleia.
Se a corrente Type representa um tipo genérico construído, este método devolve os MethodInfo objetos com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.
Se a corrente Type representa um parâmetro de tipo na definição de um tipo genérico ou método genérico, este método pesquisa os métodos da restrição de classe, ou os métodos de Object se não houver restrição de classe.
Ver também
- MethodInfo
- BindingFlags
- DefaultBinder
- GetMethod(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])