CKTIS / C#
BindingFlags — filtrar membros com reflexão
BindingFlags controla os membros de um tipo que a reflexão procura. Combine os indicadores de visibilidade e de tipo de membro com | e utilize DeclaredOnly para excluir os membros herdados.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
typeof(T).GetFields(BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static | BindingFlags.DeclaredOnly)BindingFlags é uma enumeração de indicadores em System.Reflection, utilizada, entre outras API, por Type.GetFields. Combine os valores com o operador bit a bit |, não com &. Esta é uma API da biblioteca .NET, não uma funcionalidade da linguagem que exija LangVersion=preview; o exemplo destina-se a net10.0.
BindingFlags.Public seleciona os membros públicos. BindingFlags.Instance inclui os membros associados a um objeto, enquanto BindingFlags.Static inclui os membros estáticos. Numa chamada a GetFields(flags), indique pelo menos um indicador de visibilidade (Public ou NonPublic) e pelo menos um indicador de tipo de membro (Instance ou Static); caso contrário, o resultado é vazio. Pode combinar os dois tipos de membro.
BindingFlags.DeclaredOnly restringe a pesquisa aos membros declarados diretamente no tipo analisado, excluindo os membros herdados. Não substitui os outros filtros. Sem este indicador, GetFields pode devolver campos de instância herdados; para incluir campos estáticos públicos e protegidos das classes base, é necessário BindingFlags.FlattenHierarchy. Mesmo assim, os campos estáticos privados das classes base não são devolvidos.
O exemplo procura campos públicos de instância e estáticos em Derived e, em seguida, repete a pesquisa com DeclaredOnly. O campo BaseValue desaparece, enquanto o campo privado Hidden não surge em nenhum resultado. Os nomes são ordenados explicitamente com StringComparer.Ordinal, para que a saída não dependa da ordem dos metadados.
Exemplos
using System;
using System.Reflection;
BindingFlags flags = BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static;
PrintFields(flags);
PrintFields(flags | BindingFlags.DeclaredOnly);
static void PrintFields(BindingFlags flags)
{
FieldInfo[] fields = typeof(Derived).GetFields(flags);
string[] names = Array.ConvertAll(fields, field => field.Name);
Array.Sort(names, StringComparer.Ordinal);
Console.WriteLine(string.Join(", ", names));
}
class Base
{
public int BaseValue = 1;
}
class Derived : Base
{
public static int Count = 2;
public string Name = "demo";
private int Hidden = 3;
}
Resultado
BaseValue, Count, Name Count, Name
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.