CKTIS / C#
Atributi svojstava: AttributeUsage i odabir s pomoću BindingFlags
Odredi gdje je atribut dopušten, odaberi javna svojstva instance i razlikuj izravno primijenjene atribute od atributa pronađenih nasljeđivanjem.
Verzija: C# 12 and .NET 8; later runtimes may add compatible features
Sintaksa
using System;
using System.Reflection;
// Model is the type to inspect.
PropertyInfo[] properties = typeof(Model).GetProperties(BindingFlags.Public | BindingFlags.Instance);
foreach (PropertyInfo property in properties)
{
LabelAttribute? label = property.GetCustomAttribute<LabelAttribute>(inherit: false);
}
[AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = true)]
sealed class LabelAttribute : Attribute { }[AttributeUsage(...)] skraćeni je zapis za System.AttributeUsageAttribute na klasi atributa izvedenoj iz System.Attribute. AttributeTargets.Property dopušta primjenu atributa na svojstvu neovisno o njegovoj vidljivosti ili o tome je li statičko. Cilj nije pristupnik ni pozadinsko polje. ValidOn navodi dopuštene ciljeve. AllowMultiple (zadano false) određuje smije li se atribut ponoviti na istoj deklaraciji; Inherited (zadano true) određuje može li ga naslijediti svojstvo koje nadjačava drugo svojstvo.
Type.GetProperties(BindingFlags.Public | BindingFlags.Instance) upotrebljava zastavice iz System.Reflection i vraća polje PropertyInfo[], a ne vrijednosti svojstava. Za refleksiju svojstvo je javno ako je barem jedan njegov pristupnik javan. | je bitovni ILI: preopterećena metoda sa zastavicama zahtijeva barem jednu iz para Public/NonPublic i jednu iz para Instance/Static. Dodavanjem DeclaredOnly isključuju se naslijeđena svojstva s popisa, ali se time ne upravlja naknadnom pretragom atributa.
property.GetCustomAttribute<T>(inherit: ...) metoda je proširenja iz System.Reflection.CustomAttributeExtensions za MemberInfo, baznu klasu klase PropertyInfo; nije instancijska metoda klase PropertyInfo. T mora biti izveden iz Attribute. Negenerički je ekvivalent statička metoda Attribute.GetCustomAttribute(property, typeof(T), inherit). inherit: false provjerava samo navedeno svojstvo; true pretražuje i lanac nadjačanih svojstava ako je atribut nasljediv. Instancijska metoda MemberInfo.GetCustomAttributes(..., inherit) za svojstva zanemaruje inherit.
Ako nema podudaranja, rezultat je null; više podudaranja izaziva AmbiguousMatchException. Ako očekuješ više podudaranja, upotrijebi proširenje GetCustomAttributes<T>(inherit: ...). Dohvaćanje instance atributa može izvršiti njezin konstruktor. Za pregled zapisanih argumenata bez stvaranja instance upotrijebi CustomAttributeData, koji ne traži naslijeđene atribute.
Primjeri
#nullable enable
using System;
using System.Linq;
using System.Reflection;
var usage = typeof(LabelAttribute).GetCustomAttribute<AttributeUsageAttribute>(inherit: false)
?? throw new InvalidOperationException("Missing attribute usage metadata.");
Console.WriteLine($"Usage: {usage.ValidOn}, AllowMultiple={usage.AllowMultiple}, Inherited={usage.Inherited}");
foreach (PropertyInfo property in typeof(Item)
.GetProperties(BindingFlags.Public | BindingFlags.Instance)
.OrderBy(p => p.Name, StringComparer.Ordinal))
{
var direct = property.GetCustomAttribute<LabelAttribute>(inherit: false);
var withInheritance = property.GetCustomAttribute<LabelAttribute>(inherit: true);
Console.WriteLine($"{property.Name}: direct={direct?.Text ?? "-"}; with inheritance={withInheritance?.Text ?? "-"}");
}
[AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = true)]
sealed class LabelAttribute : Attribute
{
public LabelAttribute(string text) => Text = text;
public string Text { get; }
}
class BaseItem
{
[Label("base")]
public virtual string Name => "";
}
sealed class Item : BaseItem
{
public override string Name => "";
public string Code { get; private set; } = "";
[Label("private")]
private string Hidden => "";
[Label("static")]
public static string Kind => "";
}Rezultat
Usage: Property, AllowMultiple=False, Inherited=True Code: direct=-; with inheritance=- Name: direct=-; with inheritance=base
Program prvo čita pravila uporabe za `LabelAttribute`, a zatim ispisuje svojstva ordinalnim redoslijedom po nazivu. `Code` nema oznaku, a nadjačavajuće svojstvo `Name` pronalazi `base` samo uz `inherit: true`. Označena svojstva `Hidden` i `Kind` ne prolaze filtar.
Povezane lekcije
- C# · Lekcija 24 · Napredno · Verzija: 3
Izvori
- AttributeUsageAttribute Class (System)
- AttributeTargets Enum (System)
- Attributes - C# language specification
- BindingFlags Enum (System.Reflection)
- Type.GetProperties Method (System)
- CustomAttributeExtensions.GetCustomAttribute Method (System.Reflection)
- CustomAttributeExtensions.GetCustomAttributes Method (System.Reflection)
- Attribute.GetCustomAttribute Method (System)
- MemberInfo.GetCustomAttributes Method (System.Reflection)
- CustomAttributeData Class (System.Reflection)