CKTIS / C#
BindingFlags — filtriranje članov z refleksijo
BindingFlags določa, katere člane tipa išče refleksija. Zastavice vidnosti in vrste člana združite z |, z DeclaredOnly pa izločite podedovane člane.
Različica: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
typeof(T).GetFields(BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static | BindingFlags.DeclaredOnly)BindingFlags je našteti tip zastavic v System.Reflection, ki ga med drugim uporabljajo API-ji, kot je Type.GetFields. Vrednosti združujte z bitnim operatorjem |, ne z &. To je API knjižnice .NET, ne jezikovna funkcija, za katero bi bil potreben LangVersion=preview; primer je namenjen za net10.0.
BindingFlags.Public izbere javne člane. BindingFlags.Instance vključuje člane, povezane z objektom, BindingFlags.Static pa statične člane. Pri klicu GetFields(flags) navedite vsaj eno zastavico vidnosti (Public ali NonPublic) in vsaj eno zastavico vrste člana (Instance ali Static); sicer je rezultat prazen. Združite lahko obe vrsti članov.
BindingFlags.DeclaredOnly omeji iskanje na člane, deklarirane neposredno v pregledovanem tipu, in izloči podedovane člane. Ne nadomesti drugih filtrov. Brez te zastavice lahko GetFields vrne podedovana polja primerkov; za vključitev javnih in zaščitenih statičnih polj iz osnovnih razredov je potreben BindingFlags.FlattenHierarchy. Tudi takrat se zasebna statična polja osnovnih razredov ne vrnejo.
Primer poišče javna polja primerkov in statična polja v Derived, nato pa iskanje ponovi z DeclaredOnly. Polje BaseValue izgine, zasebno polje Hidden pa se ne pojavi v nobenem rezultatu. Imena so izrecno razvrščena z StringComparer.Ordinal, zato izpis ni odvisen od vrstnega reda metapodatkov.
Primeri
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;
}
Rezultat
BaseValue, Count, Name Count, Name
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.