CKTIS / C#
BindingFlags — filtrování členů pomocí reflexe
BindingFlags určuje, které členy typu reflexe vyhledává. Kombinujte příznaky viditelnosti a druhu členu operátorem | a pomocí DeclaredOnly vylučte zděděné členy.
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
typeof(T).GetFields(BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static | BindingFlags.DeclaredOnly)BindingFlags je výčtový typ příznaků v System.Reflection, který používají mimo jiné rozhraní API jako Type.GetFields. Hodnoty kombinujte bitovým operátorem |, nikoli &. Jde o rozhraní API knihovny .NET, nikoli o jazykovou funkci vyžadující LangVersion=preview; příklad cílí na net10.0.
BindingFlags.Public vybírá veřejné členy. BindingFlags.Instance zahrnuje členy spojené s objektem, zatímco BindingFlags.Static zahrnuje statické členy. Při volání GetFields(flags) uveďte alespoň jeden příznak viditelnosti (Public nebo NonPublic) a alespoň jeden příznak druhu členu (Instance nebo Static); jinak bude výsledek prázdný. Oba druhy členů lze kombinovat.
BindingFlags.DeclaredOnly omezí vyhledávání na členy deklarované přímo v prohlíženém typu a vyloučí zděděné členy. Nenahrazuje ostatní filtry. Bez tohoto příznaku může GetFields vrátit zděděná instanční pole; k zahrnutí veřejných a chráněných statických polí ze základních tříd je potřeba BindingFlags.FlattenHierarchy. Ani potom se nevracejí soukromá statická pole ze základních tříd.
Příklad vyhledá veřejná instanční a statická pole typu Derived a poté vyhledávání zopakuje s DeclaredOnly. Pole BaseValue zmizí, zatímco soukromé pole Hidden se neobjeví v žádném výsledku. Názvy se výslovně seřadí pomocí StringComparer.Ordinal, takže výstup nezávisí na pořadí metadat.
Pří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ýsledek
BaseValue, Count, Name Count, Name
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.