CKTIS / C#
BindingFlags: filtrování metod pomocí reflexe
Kombinujte příznaky vyhledávání a vybírejte metody podle viditelnosti, podle toho, zda jsou instanční nebo statické, a podle místa deklarace.
Verze: C# 12 and .NET 8; later runtimes may add compatible features
Syntaxe
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 výčtový typ platformy .NET označený atributem [Flags]. Importujte System.Reflection pomocí using, abyste mohli použít krátký název BindingFlags. Příznaky spojte bitovým operátorem NEBO (|), nikoli operátorem ||, a výsledek předejte metodě Type.GetMethods(BindingFlags).
Viditelnost a druh metody jsou nezávislé filtry. Public zahrnuje veřejné metody a NonPublic neveřejné. Instance vybírá instanční metody a Static statické. Uveďte alespoň jeden příznak z každé dvojice. Můžete uvést i oba: Public | Instance | Static připouští veřejné metody obou druhů.
DeclaredOnly omezuje hledání na metody deklarované přímo ve zkoumaném typu. Bez něj se ve výsledku mohou objevit zděděné instanční metody, které odpovídají kritériím. Při hledání statických metod umožňuje FlattenHierarchy podle filtru viditelnosti zahrnout veřejné a chráněné statické metody základních tříd, nikoli však jejich soukromé statické metody.
Přetížení s příznaky vrací MethodInfo[]: metody popisuje, ale nevolá je. Pokud chybí některá ze dvou povinných kategorií příznaků nebo žádná metoda neodpovídá, vrátí prázdné pole. GetMethods(BindingFlags.Default) proto není totéž jako bezparametrové GetMethods(), které hledá veřejné metody.
Příklady
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() { }
}Výsledek
Instance here: Play Static here: Create Instance including inherited: Equals, GetHashCode, GetType, Play, Reset, ToString Static including inherited: Create, Help
V příkladu pro C# 12 a .NET 8 příznak `Public` vyřadí `Debug`. Bez `DeclaredOnly` hledání instančních metod najde také `Reset` a veřejné instanční metody z `object`. S `FlattenHierarchy` hledání statických metod najde i `Help`. Najde také statické metody `Equals` a `ReferenceEquals` deklarované v typu `object`, ale kód je před výpisem odfiltruje. Kód názvy výslovně řadí, místo aby spoléhal na pořadí v metadatech.
Související lekce
- C# · Lekce 23 · Pokročilá · Verze: 3