CKTIS / C#
BindingFlags: filtriranje metoda refleksijom
Kombinirajte zastavice pretraživanja da biste odabrali metode prema vidljivosti, prema tome jesu li instancijske ili statičke i prema mjestu deklaracije.
Verzija: 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 enumeracija je platforme .NET označena atributom [Flags]. Uvezite imenski prostor System.Reflection pomoću using kako biste mogli upotrebljavati kratko ime BindingFlags. Zastavice kombinirajte operatorom bitovnog ILI (|), a ne operatorom ||, i rezultat proslijedite metodi Type.GetMethods(BindingFlags).
Vidljivost i vrsta metode neovisni su filtri. Public uključuje javne metode, a NonPublic nejavne. Instance odabire instancijske metode, a Static statičke. Navedite barem jednu zastavicu iz svakog para. Možete navesti i obje: Public | Instance | Static dopušta javne metode obiju vrsta.
DeclaredOnly ograničava pretragu na metode deklarirane izravno u pregledavanom tipu. Bez te zastavice mogu se pojaviti naslijeđene instancijske metode koje zadovoljavaju kriterije. Pri pretraživanju statičkih metoda FlattenHierarchy, ovisno o filtru vidljivosti, omogućuje uključivanje javnih i zaštićenih statičkih metoda baznih klasa, ali ne i njihovih privatnih statičkih metoda.
Preopterećena metoda sa zastavicama vraća MethodInfo[]: opisuje metode, ali ih ne poziva. Vraća prazno polje ako nedostaje jedna od dviju obaveznih kategorija zastavica ili ako nijedna metoda ne odgovara kriterijima. Zato GetMethods(BindingFlags.Default) nije isto što i GetMethods() bez parametara, koji traži javne metode.
Primjeri
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
U primjeru za C# 12 i .NET 8 zastavica `Public` isključuje `Debug`. Bez `DeclaredOnly` pretraga instancijskih metoda pronalazi i `Reset` te javne instancijske metode iz `object`. Uz `FlattenHierarchy` pretraga statičkih metoda pronalazi i `Help`. Ta pretraga pronalazi i statičke metode `Equals` i `ReferenceEquals` deklarirane u tipu `object`, ali ih kod izostavlja iz ispisa. Kod izričito sortira nazive umjesto da se oslanja na redoslijed u metapodacima.
Povezane lekcije
- C# · Lekcija 23 · Napredno · Verzija: 3