KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

BindingFlags — leden filteren met reflection

BindingFlags bepaalt naar welke typen leden reflection zoekt. Combineer zichtbaarheids- en soort-lidvlaggen met | en gebruik DeclaredOnly om overgeërfde leden uit te sluiten.

Versie: .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 is een vlaggenopsomming in System.Reflection die onder meer wordt gebruikt door Type.GetFields. Combineer waarden met de bitwise-operator |, niet met &. Dit is een .NET-bibliotheek-API, geen taalfunctie waarvoor LangVersion=preview nodig is; het voorbeeld is gericht op net10.0.

BindingFlags.Public selecteert openbare leden. BindingFlags.Instance omvat leden die bij een object horen, terwijl BindingFlags.Static statische leden omvat. Geef bij een aanroep van GetFields(flags) ten minste één zichtbaarheidsvlag (Public of NonPublic) en ten minste één vlag voor het soort lid (Instance of Static) op; anders is het resultaat leeg. Je kunt beide soorten leden combineren.

BindingFlags.DeclaredOnly beperkt de zoekopdracht tot leden die rechtstreeks in het onderzochte type zijn gedeclareerd en sluit overgeërfde leden uit. Het vervangt de andere filters niet. Zonder deze vlag kan GetFields overgeërfde instantievelden teruggeven; voor openbare en beschermde statische velden uit basisklassen is BindingFlags.FlattenHierarchy vereist. Zelfs dan worden private statische velden uit basisklassen niet teruggegeven.

Het voorbeeld zoekt openbare instantie- en statische velden in Derived en herhaalt de zoekopdracht daarna met DeclaredOnly. Het veld BaseValue verdwijnt, terwijl het private veld Hidden in geen van beide resultaten voorkomt. De namen worden expliciet gesorteerd met StringComparer.Ordinal, zodat de uitvoer niet afhankelijk is van de volgorde van de metagegevens.

Voorbeelden

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;
}

Resultaat

BaseValue, Count, Name
Count, Name

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen