Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

BindingFlags: filtrovanie metód pomocou reflexie

Kombinujte príznaky vyhľadávania a vyberajte metódy podľa viditeľnosti, podľa toho, či sú inštančné alebo statické, a podľa miesta deklarácie.

Verzia: 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 je výčtový typ platformy .NET označený atribútom [Flags]. Importujte System.Reflection pomocou using, aby ste mohli použiť krátky názov BindingFlags. Príznaky spojte bitovým operátorom ALEBO (|), nie operátorom ||, a výsledok odovzdajte metóde Type.GetMethods(BindingFlags).

Viditeľnosť a druh metódy sú nezávislé filtre. Public zahŕňa verejné metódy a NonPublic neverejné. Instance vyberá inštančné metódy a Static statické. Uveďte aspoň jeden príznak z každej dvojice. Môžete uviesť aj oba: Public | Instance | Static zahŕňa verejné metódy oboch druhov.

DeclaredOnly obmedzuje vyhľadávanie na metódy deklarované priamo v skúmanom type. Bez tohto príznaku sa vo výsledku môžu objaviť zdedené inštančné metódy, ktoré spĺňajú kritériá. Pri vyhľadávaní statických metód umožňuje FlattenHierarchy podľa filtra viditeľnosti zahrnúť verejné a chránené statické metódy základných tried, nie však ich súkromné statické metódy.

Preťaženie s príznakmi vracia MethodInfo[]: metódy opisuje, ale nevolá ich. Ak chýba niektorá z dvoch povinných kategórií príznakov alebo nevyhovuje žiadna metóda, vráti prázdne pole. GetMethods(BindingFlags.Default) preto nie je to isté ako bezparametrové GetMethods(), ktoré hľadá verejné metódy.

Príklady

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() { }
}

Výsledok

Instance here: Play
Static here: Create
Instance including inherited: Equals, GetHashCode, GetType, Play, Reset, ToString
Static including inherited: Create, Help

V príklade pre C# 12 a .NET 8 príznak `Public` vyradí `Debug`. Bez `DeclaredOnly` vyhľadávanie inštančných metód nájde aj `Reset` a verejné inštančné metódy z `object`. S `FlattenHierarchy` vyhľadávanie statických metód nájde aj `Help`. Nájde aj statické metódy `Equals` a `ReferenceEquals` deklarované v type `object`, no kód ich pred výpisom odfiltruje. Kód názvy výslovne zoraďuje a nespolieha sa na poradie v metadátach.

Súvisiace lekcie

  • C# · Lekcia 23 · Pokročilá · Verzia: 3

Zdroje