CKTIS / C#
BindingFlags — filtrovanie členov pomocou reflexie
BindingFlags určuje, ktoré členy typu reflexia vyhľadáva. Kombinujte príznaky viditeľnosti a druhu člena operátorom | a pomocou DeclaredOnly vylúčte zdedené členy.
Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
typeof(T).GetFields(BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static | BindingFlags.DeclaredOnly)BindingFlags je výčtový typ príznakov v System.Reflection, ktorý používajú napríklad rozhrania API ako Type.GetFields. Hodnoty kombinujte bitovým operátorom |, nie &. Ide o rozhranie API knižnice .NET, nie o jazykovú funkciu vyžadujúcu LangVersion=preview; príklad je určený pre net10.0.
BindingFlags.Public vyberá verejné členy. BindingFlags.Instance zahŕňa členy súvisiace s objektom, zatiaľ čo BindingFlags.Static zahŕňa statické členy. Pri volaní GetFields(flags) zadajte aspoň jeden príznak viditeľnosti (Public alebo NonPublic) a aspoň jeden príznak druhu člena (Instance alebo Static); inak bude výsledok prázdny. Oba druhy členov možno kombinovať.
BindingFlags.DeclaredOnly obmedzí vyhľadávanie na členy deklarované priamo v skúmanom type a vylúči zdedené členy. Nenahrádza ostatné filtre. Bez tohto príznaku môže GetFields vrátiť zdedené inštančné polia; na zahrnutie verejných a chránených statických polí zo základných tried je potrebný BindingFlags.FlattenHierarchy. Ani potom sa nevracajú súkromné statické polia zo základných tried.
Príklad vyhľadá verejné inštančné a statické polia v Derived a potom vyhľadávanie zopakuje s DeclaredOnly. Pole BaseValue zmizne, zatiaľ čo súkromné pole Hidden sa neobjaví v žiadnom výsledku. Názvy sa výslovne zoradia pomocou StringComparer.Ordinal, takže výstup nezávisí od poradia metadát.
Príklady
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;
}
Výsledok
BaseValue, Count, Name Count, Name
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.