CKTIS / C#
GetCustomAttribute<T> — прочитане на един атрибут
CustomAttributeExtensions.GetCustomAttribute<T> извлича чрез рефлексия един атрибут от тип T. Научете кои цели се поддържат, как се обработва null и защо няколко съвпадения предизвикват изключение.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
public static T? GetCustomAttribute<T>(this System.Reflection.MemberInfo element, bool inherit) where T : Attribute;CustomAttributeExtensions.GetCustomAttribute<T> в System.Reflection предоставя методи за разширение за MemberInfo, ParameterInfo, Assembly и Module. T може да бъде самият System.Attribute или тип, който го наследява. Импортирането на using System.Reflection; позволява записа element.GetCustomAttribute<T>(); за тип използвайте typeof(Report).
Резултатът е съвпадащ атрибут от тип T или null, ако не е намерен такъв. Няколко съвпадения предизвикват AmbiguousMatchException, вместо да бъде избран първият резултат. Извикването на GetCustomAttribute<Attribute> е валидно и също предизвиква това изключение, ако има повече от един съвпадащ атрибут. Ако очаквате няколко атрибута, използвайте GetCustomAttributes<T>. Ако аргументът element е null, се предизвиква ArgumentNullException.
Претоварванията за MemberInfo и ParameterInfo приемат и bool inherit. Стойността false ограничава търсенето до атрибутите, приложени директно към елемента. При true търсенето отчита наследяването само ако елементът го поддържа. Параметър на метод, който предефинира метод от базов клас, може да наследи атрибутите на съответния параметър на базовия метод, но параметър на конструктор няма такава верига на наследяване. Атрибутите, означени с Inherited = false, не се наследяват. Примерът изрично ограничава търсенето с inherit: false; резултатът Monthly идва от LabelAttribute, приложен към Report.
Примери
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 { }
Резултат
Monthly
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.