Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

BindingFlags: filtriranje metoda refleksijom

Kombinirajte zastavice pretraživanja da biste odabrali metode prema vidljivosti, prema tome jesu li instancijske ili statičke i prema mjestu deklaracije.

Verzija: C# 12 and .NET 8; later runtimes may add compatible features

Sintaksa

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 enumeracija je platforme .NET označena atributom [Flags]. Uvezite imenski prostor System.Reflection pomoću using kako biste mogli upotrebljavati kratko ime BindingFlags. Zastavice kombinirajte operatorom bitovnog ILI (|), a ne operatorom ||, i rezultat proslijedite metodi Type.GetMethods(BindingFlags).

Vidljivost i vrsta metode neovisni su filtri. Public uključuje javne metode, a NonPublic nejavne. Instance odabire instancijske metode, a Static statičke. Navedite barem jednu zastavicu iz svakog para. Možete navesti i obje: Public | Instance | Static dopušta javne metode obiju vrsta.

DeclaredOnly ograničava pretragu na metode deklarirane izravno u pregledavanom tipu. Bez te zastavice mogu se pojaviti naslijeđene instancijske metode koje zadovoljavaju kriterije. Pri pretraživanju statičkih metoda FlattenHierarchy, ovisno o filtru vidljivosti, omogućuje uključivanje javnih i zaštićenih statičkih metoda baznih klasa, ali ne i njihovih privatnih statičkih metoda.

Preopterećena metoda sa zastavicama vraća MethodInfo[]: opisuje metode, ali ih ne poziva. Vraća prazno polje ako nedostaje jedna od dviju obaveznih kategorija zastavica ili ako nijedna metoda ne odgovara kriterijima. Zato GetMethods(BindingFlags.Default) nije isto što i GetMethods() bez parametara, koji traži javne metode.

Primjeri

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

Rezultat

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

U primjeru za C# 12 i .NET 8 zastavica `Public` isključuje `Debug`. Bez `DeclaredOnly` pretraga instancijskih metoda pronalazi i `Reset` te javne instancijske metode iz `object`. Uz `FlattenHierarchy` pretraga statičkih metoda pronalazi i `Help`. Ta pretraga pronalazi i statičke metode `Equals` i `ReferenceEquals` deklarirane u tipu `object`, ali ih kod izostavlja iz ispisa. Kod izričito sortira nazive umjesto da se oslanja na redoslijed u metapodacima.

Povezane lekcije

  • C# · Lekcija 23 · Napredno · Verzija: 3

Izvori