CKTIS / C#
GetCustomAttribute<T> — branje enega atributa
CustomAttributeExtensions.GetCustomAttribute<T> z refleksijo pridobi en atribut tipa T. Spoznajte podprte cilje, obravnavo vrednosti null in razlog, zakaj več ujemanj povzroči izjemo.
Različica: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
public static T? GetCustomAttribute<T>(this System.Reflection.MemberInfo element, bool inherit) where T : Attribute;CustomAttributeExtensions.GetCustomAttribute<T> v System.Reflection ponuja razširitvene metode za MemberInfo, ParameterInfo, Assembly in Module. T je lahko sam tip System.Attribute ali tip, izpeljan iz njega. Uvoz using System.Reflection; omogoča zapis element.GetCustomAttribute<T>(); za tip uporabite typeof(Report).
Rezultat je ujemajoči se atribut tipa T ali null, če ni najden noben. Več ujemanj povzroči AmbiguousMatchException, namesto da bi bila izbrana prva najdba. Klic GetCustomAttribute<Attribute> je veljaven in prav tako sproži to izjemo, če se ujema več kot en atribut. Če pričakujete več atributov, uporabite GetCustomAttributes<T>. Če je argument element enak null, se sproži ArgumentNullException.
Preobremenitve za MemberInfo in ParameterInfo sprejemajo tudi bool inherit. Vrednost false omeji iskanje na atribute, ki so uporabljeni neposredno na ciljnem elementu. Vrednost true upošteva dedovanje le, če ga ciljni element podpira. Parameter metode, ki prepiše metodo osnovnega razreda, lahko podeduje atribute ustreznega parametra metode osnovnega razreda, parameter konstruktorja pa takšne dedne verige nima. Atributi z nastavitvijo Inherited = false se ne dedujejo. Primer izrecno omeji iskanje z inherit: false; rezultat Monthly izvira iz atributa LabelAttribute, uporabljenega na Report.
Primeri
using System;
using System.Reflection;
LabelAttribute? label = typeof(Report)
.GetCustomAttribute<LabelAttribute>(inherit: false);
Console.WriteLine(label?.Text ?? "missing");
[AttributeUsage(AttributeTargets.Class)]
public sealed class LabelAttribute : Attribute
{
public LabelAttribute(string text) => Text = text;
public string Text { get; }
}
[Label("Monthly")]
public sealed class Report { }
Rezultat
Monthly
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.