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.