CKTIS / C#
GetCustomAttribute<T> — één attribuut uitlezen
CustomAttributeExtensions.GetCustomAttribute<T> haalt via reflection één attribuut van type T op. Ontdek welke doelen worden ondersteund, hoe null wordt afgehandeld en waarom meerdere overeenkomsten een uitzondering veroorzaken.
Versie: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
public static T? GetCustomAttribute<T>(this System.Reflection.MemberInfo element, bool inherit) where T : Attribute;CustomAttributeExtensions.GetCustomAttribute<T> in System.Reflection biedt extensiemethoden voor MemberInfo, ParameterInfo, Assembly en Module. T kan System.Attribute zelf zijn of een daarvan afgeleid type. Met de import using System.Reflection; kun je element.GetCustomAttribute<T>() schrijven; gebruik voor een type typeof(Report).
Het resultaat is een overeenkomend attribuut van type T, of null als er geen wordt gevonden. Meerdere overeenkomsten veroorzaken AmbiguousMatchException in plaats van dat het eerste resultaat wordt gekozen. Een aanroep van GetCustomAttribute<Attribute> is geldig en werpt deze uitzondering ook op als er meer dan één passend attribuut wordt gevonden. Gebruik GetCustomAttributes<T> als je meerdere attributen verwacht. Als het argument element gelijk is aan null, wordt ArgumentNullException veroorzaakt.
Overloads voor MemberInfo en ParameterInfo accepteren ook bool inherit. Met false worden alleen attributen opgezocht die rechtstreeks op het doel zijn toegepast. Met true telt overerving alleen mee als het doel die ondersteunt. Een parameter van een overschrijvende methode kan attributen erven van de overeenkomstige parameter van de basismethode, maar een constructorparameter heeft geen dergelijke overervingsketen. Attributen met Inherited = false worden niet overgeërfd. Het voorbeeld beperkt de zoekopdracht expliciet met inherit: false; het resultaat Monthly komt van LabelAttribute dat op Report is toegepast.
Voorbeelden
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 { }
Resultaat
Monthly
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.