WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

BindingFlags — Member mit Reflection filtern

BindingFlags legt fest, nach welchen Typmembern Reflection sucht. Kombinieren Sie Sichtbarkeits- und Memberart-Flags mit | und verwenden Sie DeclaredOnly, um geerbte Member auszuschließen.

Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntax

typeof(T).GetFields(BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static | BindingFlags.DeclaredOnly)

BindingFlags ist eine Flags-Aufzählung in System.Reflection, die unter anderem von Type.GetFields verwendet wird. Kombinieren Sie Werte mit dem bitweisen Operator |, nicht mit &. Dies ist eine .NET-Bibliotheks-API und kein Sprachmerkmal, das LangVersion=preview erfordert; das Beispiel zielt auf net10.0 ab.

BindingFlags.Public wählt öffentliche Member aus. BindingFlags.Instance umfasst Member, die zu einem Objekt gehören, während BindingFlags.Static statische Member umfasst. Geben Sie bei einem Aufruf von GetFields(flags) mindestens ein Sichtbarkeits-Flag (Public oder NonPublic) und mindestens ein Flag für die Memberart (Instance oder Static) an; andernfalls ist das Ergebnis leer. Sie können beide Memberarten kombinieren.

BindingFlags.DeclaredOnly beschränkt die Suche auf Member, die direkt im untersuchten Typ deklariert sind, und schließt geerbte Member aus. Es ersetzt die anderen Filter nicht. Ohne dieses Flag kann GetFields geerbte Instanzfelder zurückgeben; um öffentliche und geschützte statische Felder aus Basisklassen einzubeziehen, ist BindingFlags.FlattenHierarchy erforderlich. Private statische Felder aus Basisklassen werden auch dann nicht zurückgegeben.

Das Beispiel sucht nach öffentlichen Instanz- und statischen Feldern in Derived und wiederholt die Suche anschließend mit DeclaredOnly. Das Feld BaseValue fällt weg, während das private Feld Hidden in keinem Ergebnis erscheint. Die Namen werden ausdrücklich mit StringComparer.Ordinal sortiert, damit die Ausgabe nicht von der Reihenfolge der Metadaten abhängt.

Beispiele

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;
}

Ergebnis

BaseValue, Count, Name
Count, Name

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen