Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

BindingFlags — filtrowanie elementów przez refleksję

BindingFlags określa, jakie elementy typu ma wyszukać refleksja. Łącz flagi widoczności i rodzaju elementu operatorem |, a przez DeclaredOnly wykluczaj elementy odziedziczone.

Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Składnia

typeof(T).GetFields(BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static | BindingFlags.DeclaredOnly)

BindingFlags to wyliczenie flag w System.Reflection, używane m.in. przez Type.GetFields. Wartości łączy się bitowym operatorem |, nie operatorem &. Jest to API biblioteki .NET, a nie funkcja języka wymagająca LangVersion=preview; przykład jest przeznaczony dla net10.0.

BindingFlags.Public wybiera elementy publiczne. BindingFlags.Instance obejmuje elementy związane z obiektem, a BindingFlags.Static — elementy statyczne. W wywołaniu GetFields(flags) podaj co najmniej jedną flagę widoczności (Public lub NonPublic) i co najmniej jedną flagę rodzaju (Instance lub Static); inaczej wynik będzie pusty. Oba rodzaje można połączyć.

BindingFlags.DeclaredOnly ogranicza wyszukiwanie do elementów zadeklarowanych bezpośrednio w badanym typie, wykluczając odziedziczone. Nie zastępuje pozostałych filtrów. Bez tej flagi GetFields może zwracać odziedziczone pola instancji; dla publicznych i chronionych pól statycznych klas bazowych potrzebne jest BindingFlags.FlattenHierarchy. Prywatne pola statyczne klas bazowych nie są wtedy zwracane.

Przykład wyszukuje publiczne pola instancji i statyczne typu Derived, a następnie powtarza wyszukiwanie z DeclaredOnly. Pole BaseValue znika, natomiast prywatne Hidden nie występuje w żadnym wyniku. Nazwy są jawnie sortowane przez StringComparer.Ordinal, aby wynik nie zależał od kolejności metadanych.

Przykłady

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

Wynik

BaseValue, Count, Name
Count, Name

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła