Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C#

BindingFlags — filtrare i membri con la reflection

BindingFlags controlla quali membri di un tipo vengono cercati dalla reflection. Combina con | i flag di visibilità e di tipo di membro e usa DeclaredOnly per escludere i membri ereditati.

Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintassi

typeof(T).GetFields(BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static | BindingFlags.DeclaredOnly)

BindingFlags è un’enumerazione di flag in System.Reflection, usata tra l’altro da Type.GetFields. Combina i valori con l’operatore bitwise |, non con &. È un’API della libreria .NET, non una funzionalità del linguaggio che richiede LangVersion=preview; l’esempio è destinato a net10.0.

BindingFlags.Public seleziona i membri pubblici. BindingFlags.Instance include i membri associati a un oggetto, mentre BindingFlags.Static include quelli statici. In una chiamata a GetFields(flags), specifica almeno un flag di visibilità (Public o NonPublic) e almeno un flag di tipo di membro (Instance o Static); altrimenti il risultato è vuoto. È possibile combinare entrambi i tipi di membro.

BindingFlags.DeclaredOnly limita la ricerca ai membri dichiarati direttamente nel tipo esaminato, escludendo quelli ereditati. Non sostituisce gli altri filtri. Senza questo flag, GetFields può restituire campi di istanza ereditati; per includere i campi statici pubblici e protetti delle classi base è necessario BindingFlags.FlattenHierarchy. Anche in tal caso, i campi statici privati delle classi base non vengono restituiti.

L’esempio cerca i campi pubblici di istanza e statici in Derived, quindi ripete la ricerca con DeclaredOnly. Il campo BaseValue scompare, mentre il campo privato Hidden non compare in nessuno dei risultati. I nomi vengono ordinati esplicitamente con StringComparer.Ordinal, così l’output non dipende dall’ordine dei metadati.

Esempi

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;
}

Risultato

BaseValue, Count, Name
Count, Name

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti