Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje