Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

BindingFlags — filtriranje članova pomoću refleksije

BindingFlags određuje koje članove tipa refleksija pretražuje. Kombinirajte zastavice vidljivosti i vrste člana operatorom |, a pomoću DeclaredOnly isključite naslijeđene članove.

Verzija: .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 enumeracija zastavica u System.Reflection, koju koriste, među ostalim, API-ji kao što je Type.GetFields. Vrijednosti kombinirajte bitovnim operatorom |, a ne operatorom &. To je API biblioteke .NET, a ne jezična značajka za koju je potreban LangVersion=preview; primjer je namijenjen za net10.0.

BindingFlags.Public odabire javne članove. BindingFlags.Instance uključuje članove povezane s objektom, dok BindingFlags.Static uključuje statičke članove. U pozivu GetFields(flags) navedite barem jednu zastavicu vidljivosti (Public ili NonPublic) i barem jednu zastavicu vrste člana (Instance ili Static); u suprotnom je rezultat prazan. Možete kombinirati obje vrste članova.

BindingFlags.DeclaredOnly ograničava pretraživanje na članove izravno deklarirane u pregledavanom tipu, isključujući naslijeđene članove. Ne zamjenjuje ostale filtre. Bez te zastavice GetFields može vratiti naslijeđena polja instance; za uključivanje javnih i zaštićenih statičkih polja osnovnih klasa potreban je BindingFlags.FlattenHierarchy. Ni tada se privatna statička polja osnovnih klasa ne vraćaju.

Primjer traži javna polja instance i statička polja u Derived, a zatim ponavlja pretraživanje uz DeclaredOnly. Polje BaseValue nestaje, dok se privatno polje Hidden ne pojavljuje ni u jednom rezultatu. Nazivi se izričito sortiraju pomoću StringComparer.Ordinal, pa izlaz ne ovisi o redoslijedu metapodataka.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori