Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri