CKTIS / C#
BindingFlags: filtrar métodos por reflexão
Combina sinalizadores de pesquisa para selecionar métodos por visibilidade, por serem de instância ou estáticos e pelo tipo que os declara.
Versão: C# 12 and .NET 8; later runtimes may add compatible features
Sintaxe
using System.Reflection;
BindingFlags flags = BindingFlags.Public | BindingFlags.Instance | BindingFlags.DeclaredOnly;
MethodInfo[] methods = typeof(T).GetMethods(flags); // T is the type to inspect.
// Use BindingFlags.Static instead of Instance for static methods,
// or combine Instance | Static to include both.System.Reflection.BindingFlags é uma enumeração do .NET marcada com o atributo [Flags]. Importa System.Reflection com using para escrever o nome abreviado BindingFlags. Combina os sinalizadores com o operador OU bit a bit (|), não com ||, e passa o resultado a Type.GetMethods(BindingFlags).
A visibilidade e a natureza do método são filtros independentes. Public inclui métodos públicos e NonPublic inclui métodos não públicos. Instance seleciona métodos de instância e Static seleciona métodos estáticos. Indica pelo menos um sinalizador de cada par. Também podes indicar ambos: Public | Instance | Static admite métodos públicos dos dois tipos.
DeclaredOnly limita a pesquisa aos métodos declarados diretamente no tipo analisado. Sem este sinalizador, podem surgir métodos de instância herdados que satisfaçam os critérios. Numa pesquisa de métodos estáticos, FlattenHierarchy permite incluir métodos estáticos públicos e protegidos das classes base, consoante o filtro de visibilidade, mas não os seus métodos estáticos privados.
A sobrecarga com sinalizadores devolve um MethodInfo[]: descreve os métodos sem os invocar. Devolve um array vazio se faltar uma das duas categorias de sinalizadores obrigatórias ou se nenhum método corresponder aos critérios. Assim, GetMethods(BindingFlags.Default) não equivale a GetMethods() sem parâmetros, que pesquisa métodos públicos.
Exemplos
using System;
using System.Linq;
using System.Reflection;
Type type = typeof(Player);
const BindingFlags publicInstance = BindingFlags.Public | BindingFlags.Instance;
const BindingFlags publicStatic = BindingFlags.Public | BindingFlags.Static;
Print("Instance here", type, publicInstance | BindingFlags.DeclaredOnly);
Print("Static here", type, publicStatic | BindingFlags.DeclaredOnly);
Print("Instance including inherited", type, publicInstance);
Print("Static including inherited", type, publicStatic | BindingFlags.FlattenHierarchy);
static void Print(string label, Type type, BindingFlags flags)
{
var names = type.GetMethods(flags)
// Keep object instance methods, but omit static methods declared on object.
.Where(method => !method.IsStatic || method.DeclaringType != typeof(object))
.Select(method => method.Name)
.OrderBy(name => name, StringComparer.Ordinal);
Console.WriteLine($"{label}: {string.Join(", ", names)}");
}
class BasePlayer
{
public void Reset() { }
public static void Help() { }
}
class Player : BasePlayer
{
public void Play() { }
public static void Create() { }
private void Debug() { }
}Resultado
Instance here: Play Static here: Create Instance including inherited: Equals, GetHashCode, GetType, Play, Reset, ToString Static including inherited: Create, Help
Neste exemplo para C# 12 e .NET 8, `Public` exclui `Debug`. Sem `DeclaredOnly`, a pesquisa de métodos de instância também encontra `Reset` e os métodos de instância públicos de `object`. Com `FlattenHierarchy`, a pesquisa de métodos estáticos encontra `Help`. Esta pesquisa também encontra os métodos estáticos `Equals` e `ReferenceEquals` declarados em `object`, mas o código exclui-os antes de apresentar os resultados. O código ordena explicitamente os nomes, sem depender da ordem dos metadados.
Lições relacionadas
- C# · Lição 23 · Avançado · Versão: 3