CKTIS / C#
GetCustomAttribute<T> — leggere un singolo attributo
CustomAttributeExtensions.GetCustomAttribute<T> recupera tramite reflection un singolo attributo di tipo T. Scopri gli elementi supportati, come viene gestito null e perché più corrispondenze causano un’eccezione.
Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintassi
public static T? GetCustomAttribute<T>(this System.Reflection.MemberInfo element, bool inherit) where T : Attribute;CustomAttributeExtensions.GetCustomAttribute<T> in System.Reflection fornisce metodi di estensione per MemberInfo, ParameterInfo, Assembly e Module. T può essere System.Attribute stesso o un tipo da esso derivato. Importando using System.Reflection; puoi scrivere element.GetCustomAttribute<T>(); per un tipo, usa typeof(Report).
Il risultato è un attributo corrispondente di tipo T oppure null se non ne viene trovato alcuno. Più corrispondenze causano AmbiguousMatchException, invece di selezionare il primo risultato. Una chiamata a GetCustomAttribute<Attribute> è valida e genera anch’essa questa eccezione se viene trovato più di un attributo corrispondente. Se ti aspetti più attributi, usa GetCustomAttributes<T>. Se l’argomento element è null, viene generata ArgumentNullException.
Gli overload per MemberInfo e ParameterInfo accettano anche bool inherit. Con false la ricerca si limita agli attributi applicati direttamente all’elemento. Con true tiene conto dell’ereditarietà solo se l’elemento la supporta. Il parametro di un metodo che esegue l’override di un metodo di base può ereditare gli attributi dal parametro corrispondente del metodo di base, mentre un parametro di un costruttore non ha una catena di ereditarietà di questo tipo. Gli attributi contrassegnati con Inherited = false non vengono ereditati. L’esempio limita esplicitamente la ricerca con inherit: false; il risultato Monthly proviene da LabelAttribute applicato a Report.
Esempi
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 { }
Risultato
Monthly
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.