Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes