CKTIS / C#
BindingFlags — filtrer les membres avec la réflexion
BindingFlags détermine quels membres d’un type la réflexion recherche. Combinez les indicateurs de visibilité et de type de membre avec |, et utilisez DeclaredOnly pour exclure les membres hérités.
Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
typeof(T).GetFields(BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static | BindingFlags.DeclaredOnly)BindingFlags est une énumération d’indicateurs de System.Reflection, utilisée notamment par Type.GetFields. Combinez les valeurs avec l’opérateur bit à bit |, et non avec &. Il s’agit d’une API de bibliothèque .NET, pas d’une fonctionnalité du langage nécessitant LangVersion=preview ; l’exemple cible net10.0.
BindingFlags.Public sélectionne les membres publics. BindingFlags.Instance inclut les membres associés à un objet, tandis que BindingFlags.Static inclut les membres statiques. Dans un appel à GetFields(flags), indiquez au moins un indicateur de visibilité (Public ou NonPublic) et au moins un indicateur de type de membre (Instance ou Static) ; sinon, le résultat est vide. Vous pouvez combiner les deux types de membres.
BindingFlags.DeclaredOnly limite la recherche aux membres déclarés directement dans le type examiné, en excluant les membres hérités. Il ne remplace pas les autres filtres. Sans cet indicateur, GetFields peut renvoyer des champs d’instance hérités ; pour inclure les champs statiques publics et protégés des classes de base, il faut BindingFlags.FlattenHierarchy. Même dans ce cas, les champs statiques privés des classes de base ne sont pas renvoyés.
L’exemple recherche les champs publics d’instance et statiques de Derived, puis répète la recherche avec DeclaredOnly. Le champ BaseValue disparaît, tandis que le champ privé Hidden ne figure dans aucun résultat. Les noms sont explicitement triés avec StringComparer.Ordinal afin que la sortie ne dépende pas de l’ordre des métadonnées.
Exemples
using System;
using System.Reflection;
BindingFlags flags = BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static;
PrintFields(flags);
PrintFields(flags | BindingFlags.DeclaredOnly);
static void PrintFields(BindingFlags flags)
{
FieldInfo[] fields = typeof(Derived).GetFields(flags);
string[] names = Array.ConvertAll(fields, field => field.Name);
Array.Sort(names, StringComparer.Ordinal);
Console.WriteLine(string.Join(", ", names));
}
class Base
{
public int BaseValue = 1;
}
class Derived : Base
{
public static int Count = 2;
public string Name = "demo";
private int Hidden = 3;
}
Résultat
BaseValue, Count, Name Count, Name
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.