CKTIS / C#
BindingFlags: methoden filteren met reflectie
Combineer zoekvlaggen om methoden te selecteren op zichtbaarheid, op instantiemethode of statische methode en op het type dat ze declareert.
Versie: C# 12 and .NET 8; later runtimes may add compatible features
Syntax
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 is een .NET-enum met het attribuut [Flags]. Importeer System.Reflection met using om de korte naam BindingFlags te gebruiken. Combineer de vlaggen met bitsgewijze OF (|), niet met ||, en geef het resultaat door aan Type.GetMethods(BindingFlags).
Zichtbaarheid en het soort methode zijn onafhankelijke filters. Public neemt openbare methoden mee en NonPublic niet-openbare methoden. Instance selecteert instantiemethoden en Static statische methoden. Geef minstens één vlag uit elk paar op. Je kunt ook beide opgeven: Public | Instance | Static laat openbare methoden van beide soorten toe.
DeclaredOnly beperkt de zoekopdracht tot methoden die rechtstreeks op het onderzochte type zijn gedeclareerd. Zonder deze vlag kunnen geërfde instantiemethoden die aan de filters voldoen in het resultaat verschijnen. Bij een zoekopdracht naar statische methoden kan FlattenHierarchy, afhankelijk van het zichtbaarheidsfilter, openbare en beschermde statische methoden uit basisklassen meenemen, maar geen private statische methoden uit die klassen.
De overload met vlaggen retourneert een MethodInfo[]: deze bevat informatie over de methoden, zonder ze aan te roepen. De array is leeg als een van de twee vereiste categorieën vlaggen ontbreekt of als niets overeenkomt. Daarom is GetMethods(BindingFlags.Default) niet hetzelfde als GetMethods() zonder parameters, dat naar openbare methoden zoekt.
Voorbeelden
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() { }
}Resultaat
Instance here: Play Static here: Create Instance including inherited: Equals, GetHashCode, GetType, Play, Reset, ToString Static including inherited: Create, Help
In dit voorbeeld voor C# 12 en .NET 8 sluit `Public` de methode `Debug` uit. Zonder `DeclaredOnly` vindt de zoekopdracht naar instantiemethoden ook `Reset` en openbare instantiemethoden van `object`. Met `FlattenHierarchy` vindt de zoekopdracht naar statische methoden ook `Help`. Die zoekopdracht vindt ook de statische methoden `Equals` en `ReferenceEquals` die in `object` zijn gedeclareerd, maar de code filtert ze uit voordat de resultaten worden afgedrukt. De code sorteert de namen expliciet en vertrouwt niet op de volgorde in de metadata.
Gerelateerde lessen
- C# · Les 23 · Gevorderd · Versie: 3