Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje