Type.GetMethods Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém os métodos do atual Type.
Sobrecargas
| Nome | Description |
|---|---|
| GetMethods() |
Retorna todos os métodos públicos do atual Type. |
| GetMethods(BindingFlags) |
Quando substituído em uma classe derivada, pesquisa os métodos definidos para o atual Type, usando as restrições de associação especificadas. |
GetMethods()
- Origem:
- Type.cs
- Origem:
- Type.cs
- Origem:
- Type.cs
- Origem:
- Type.cs
- Origem:
- Type.cs
Retorna todos os métodos públicos do atual Type.
public:
cli::array <System::Reflection::MethodInfo ^> ^ GetMethods();
public:
virtual cli::array <System::Reflection::MethodInfo ^> ^ GetMethods();
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicMethods)]
public System.Reflection.MethodInfo[] GetMethods();
public System.Reflection.MethodInfo[] GetMethods();
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicMethods)>]
member this.GetMethods : unit -> System.Reflection.MethodInfo[]
member this.GetMethods : unit -> System.Reflection.MethodInfo[]
abstract member GetMethods : unit -> System.Reflection.MethodInfo[]
override this.GetMethods : unit -> System.Reflection.MethodInfo[]
Public Function GetMethods () As MethodInfo()
Retornos
Uma matriz de MethodInfo objetos que representa todos os métodos públicos definidos para o atual Type.
- ou -
Uma matriz vazia de tipo MethodInfo, se nenhum método público for definido para o atual Type.
Implementações
- Atributos
Comentários
Em versões .NET 6 e anteriores, o método GetMethods não retorna métodos em uma ordem específica, como ordem alfabética ou de declaração. Seu código não deve depender da ordem na qual os métodos são retornados, pois essa ordem varia. No entanto, começando com .NET 7, a ordenação é determinística com base na ordenação de metadados no assembly.
Os construtores não estão incluídos na matriz de métodos retornados por essa chamada. Faça uma chamada separada para GetConstructors() obter os métodos do construtor.
A tabela a seguir mostra quais membros de uma classe base são retornados pelos métodos Get ao refletir sobre um tipo.
| Tipo de Membro | Estático | Não estático |
|---|---|---|
| Construtor | No | No |
| Campo | No | Sim. Um campo permanece sempre oculto por nome e assinatura. |
| Acontecimento | Não aplicável | A regra de sistema do 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 | No | Sim. Um método (virtual e não virtual) pode permanecer oculto por nome ou por nome e assinatura. |
| Tipo aninhado | No | No |
| Propriedade | Não aplicável | A regra de sistema do 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. |
Oculto por nome e assinatura considera todas as partes da assinatura, inclusive modificadores personalizados, tipos de retorno, tipos de parâmetro, sentinelas e convenções de chamada não gerenciadas. Essa é uma comparação binária.
Para reflexão, propriedades e eventos permanecem ocultos 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 acessador get, a propriedade de classe derivada ocultará a propriedade de classe base e você não poderá acessar o setter na classe base.
Atributos personalizados não fazem parte do sistema de tipos comuns.
Observação
Você não pode omitir parâmetros ao procurar construtores e métodos. Você só pode omitir parâmetros ao invocar.
Se a corrente Type representar um tipo genérico construído, esse método retornará os MethodInfo objetos 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.
Confira também
Aplica-se a
GetMethods(BindingFlags)
- Origem:
- Type.cs
- Origem:
- Type.cs
- Origem:
- Type.cs
- Origem:
- Type.cs
- Origem:
- Type.cs
Quando substituído em uma classe derivada, pesquisa os métodos definidos para o atual Type, usando as restrições de associação especificadas.
public:
abstract cli::array <System::Reflection::MethodInfo ^> ^ GetMethods(System::Reflection::BindingFlags bindingAttr);
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicMethods | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicMethods)]
public abstract System.Reflection.MethodInfo[] GetMethods(System.Reflection.BindingFlags bindingAttr);
public abstract System.Reflection.MethodInfo[] GetMethods(System.Reflection.BindingFlags bindingAttr);
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicMethods | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicMethods)>]
abstract member GetMethods : System.Reflection.BindingFlags -> System.Reflection.MethodInfo[]
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 especificam como a pesquisa é conduzida.
- ou -
Default para retornar uma matriz vazia.
Retornos
Uma matriz de MethodInfo objetos que representa todos os métodos definidos para a corrente Type que correspondem às restrições de associação especificadas.
- ou -
Uma matriz vazia de tipo MethodInfo, se nenhum método for definido para o atual Typeou se nenhum dos métodos definidos corresponder às restrições de associação.
Implementações
- Atributos
Exemplos
O exemplo a seguir 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 exibe 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
Comentários
Para que a GetMethods(BindingFlags) sobrecarga recupere com êxito as informações do método, o bindingAttr argumento deve incluir pelo menos um e BindingFlags.InstanceBindingFlags.Static, juntamente com pelo menos um de BindingFlags.NonPublic e BindingFlags.Public.
Os seguintes sinalizadores de filtro de BindingFlags podem ser usados para definir quais métodos incluir na pesquisa:
Especifique
BindingFlags.Instancepara incluir métodos de instância.Especifique
BindingFlags.Staticpara incluir métodos estáticos.Especifique
BindingFlags.Publicpara incluir métodos públicos na pesquisa.Especifique
BindingFlags.NonPublicpara incluir métodos não públicos (ou seja, métodos privados, internos e protegidos) na pesquisa. Somente métodos protegidos e internos em classes base são retornados; métodos privados em classes base não são retornados.Especifique
BindingFlags.FlattenHierarchypara incluirpubliceprotectedmembros estáticos na hierarquia;privatemembros estáticos em classes herdadas não estão incluídos.Especifique
BindingFlags.Defaultsozinho para retornar uma matriz vazia MethodInfo .
Os seguintes sinalizadores de modificador BindingFlags podem ser usados para alterar como a pesquisa funciona:
-
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 retorna métodos em uma ordem específica, como ordem alfabética ou de declaração. Seu código não deve depender da ordem na qual os métodos são retornados, pois essa ordem varia. No entanto, começando com .NET 7, a ordenação é determinística com base na ordenação de metadados no assembly.
Se a corrente Type representar um tipo genérico construído, esse método retornará os MethodInfo objetos 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.
Confira também
- MethodInfo
- BindingFlags
- DefaultBinder
- GetMethod(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])