CKTIS / C#
BindingFlags : filtrer les méthodes par réflexion
Combinez des indicateurs de recherche pour sélectionner les méthodes selon leur visibilité, leur nature et le type qui les déclare.
Version : 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 est une énumération .NET marquée par l’attribut [Flags]. Importez System.Reflection avec using pour utiliser le nom court BindingFlags. Combinez les indicateurs avec le OU bit à bit (|), et non avec ||, puis passez le résultat à Type.GetMethods(BindingFlags).
La visibilité et la nature de la méthode sont deux filtres indépendants. Public inclut les méthodes publiques, et NonPublic les méthodes non publiques. Instance sélectionne les méthodes d’instance, et Static les méthodes statiques. Indiquez au moins un membre de chaque paire. Vous pouvez aussi indiquer les deux : Public | Instance | Static admet les méthodes publiques des deux sortes.
DeclaredOnly limite la recherche aux méthodes déclarées directement dans le type examiné. Sans cet indicateur, des méthodes d’instance héritées peuvent apparaître si elles correspondent aux critères. Pour une recherche statique, FlattenHierarchy permet d’inclure les méthodes statiques publiques et protégées des classes de base, selon le filtre de visibilité, mais pas leurs méthodes statiques privées.
La surcharge avec indicateurs renvoie un MethodInfo[] : elle décrit les méthodes sans les appeler. Le tableau est vide si l’une des deux catégories d’indicateurs requises manque ou si aucune méthode ne correspond. GetMethods(BindingFlags.Default) est donc différent de GetMethods() sans paramètre, qui recherche les méthodes publiques.
Exemples
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() { }
}Résultat
Instance here: Play Static here: Create Instance including inherited: Equals, GetHashCode, GetType, Play, Reset, ToString Static including inherited: Create, Help
Dans cet exemple pour C# 12 et .NET 8, `Public` exclut `Debug`. Sans `DeclaredOnly`, la recherche des méthodes d’instance trouve aussi `Reset` et les méthodes d’instance publiques de `object`. Avec `FlattenHierarchy`, la recherche des méthodes statiques trouve `Help`. Elle trouve aussi les méthodes statiques `Equals` et `ReferenceEquals` déclarées dans `object`, mais le code les écarte avant l’affichage. Le code trie explicitement les noms au lieu de s’appuyer sur l’ordre des métadonnées.
Leçons associées
- C# · Leçon 23 · Avancé · Version : 3