CKTIS / C#
BindingFlags: filtriranje metod z refleksijo
Združite zastavice za iskanje in izberite metode glede na vidnost, glede na to, ali so instančne ali statične, in glede na mesto deklaracije.
Različica: C# 12 and .NET 8; later runtimes may add compatible features
Sintaksa
using System.Reflection;
BindingFlags flags = BindingFlags.Public | BindingFlags.Instance | BindingFlags.DeclaredOnly;
MethodInfo[] methods = typeof(T).GetMethods(flags); // T is the type to inspect.
// Use BindingFlags.Static instead of Instance for static methods,
// or combine Instance | Static to include both.System.Reflection.BindingFlags je naštevni tip v okolju .NET, označen z atributom [Flags]. Imenski prostor System.Reflection uvozite z using, da lahko uporabite kratko ime BindingFlags. Zastavice združite z bitnim operatorjem ALI (|), ne z ||, in rezultat posredujte metodi Type.GetMethods(BindingFlags).
Vidnost in vrsta metode sta neodvisna filtra. Public vključi javne metode, NonPublic pa nejavne. Instance izbere instančne metode, Static pa statične. Podajte vsaj eno zastavico iz vsakega para. Lahko podate tudi obe: Public | Instance | Static dopušča javne metode obeh vrst.
DeclaredOnly omeji iskanje na metode, deklarirane neposredno v pregledovanem tipu. Brez te zastavice se lahko v rezultatih pojavijo podedovane instančne metode, ki ustrezajo merilom. Pri iskanju statičnih metod FlattenHierarchy glede na filter vidnosti omogoča vključitev javnih in zaščitenih statičnih metod osnovnih razredov, ne pa njihovih zasebnih statičnih metod.
Preobremenitev z zastavicami vrne MethodInfo[]: metode opiše, ne da bi jih poklicala. Vrne prazno polje, če manjka katera od dveh zahtevanih kategorij zastavic ali če nobena metoda ne ustreza. Zato GetMethods(BindingFlags.Default) ni isto kot GetMethods() brez parametrov, ki išče javne metode.
Primeri
using System;
using System.Linq;
using System.Reflection;
Type type = typeof(Player);
const BindingFlags publicInstance = BindingFlags.Public | BindingFlags.Instance;
const BindingFlags publicStatic = BindingFlags.Public | BindingFlags.Static;
Print("Instance here", type, publicInstance | BindingFlags.DeclaredOnly);
Print("Static here", type, publicStatic | BindingFlags.DeclaredOnly);
Print("Instance including inherited", type, publicInstance);
Print("Static including inherited", type, publicStatic | BindingFlags.FlattenHierarchy);
static void Print(string label, Type type, BindingFlags flags)
{
var names = type.GetMethods(flags)
// Keep object instance methods, but omit static methods declared on object.
.Where(method => !method.IsStatic || method.DeclaringType != typeof(object))
.Select(method => method.Name)
.OrderBy(name => name, StringComparer.Ordinal);
Console.WriteLine($"{label}: {string.Join(", ", names)}");
}
class BasePlayer
{
public void Reset() { }
public static void Help() { }
}
class Player : BasePlayer
{
public void Play() { }
public static void Create() { }
private void Debug() { }
}Rezultat
Instance here: Play Static here: Create Instance including inherited: Equals, GetHashCode, GetType, Play, Reset, ToString Static including inherited: Create, Help
V primeru za C# 12 in .NET 8 zastavica `Public` izloči `Debug`. Brez `DeclaredOnly` iskanje instančnih metod najde tudi `Reset` in javne instančne metode iz `object`. Z `FlattenHierarchy` iskanje statičnih metod najde tudi `Help`. Najde tudi statični metodi `Equals` in `ReferenceEquals`, deklarirani v tipu `object`, vendar ju koda pred izpisom izloči. Koda imena izrecno razvrsti, namesto da bi se zanašala na vrstni red v metapodatkih.
Povezane lekcije
- C# · Lekcija 23 · Napredna · Različica: 3