CKTIS / C#
GetCustomAttribute<T> — načítanie jedného atribútu
CustomAttributeExtensions.GetCustomAttribute<T> načíta pomocou reflexie jeden atribút typu T. Zistite, ktoré ciele podporuje, ako spracúva null a prečo viacero zhôd vyvolá výnimku.
Verzia: .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> v System.Reflection poskytuje rozširujúce metódy pre MemberInfo, ParameterInfo, Assembly a Module. Typom T môže byť samotný System.Attribute alebo typ od neho odvodený. Import using System.Reflection; umožňuje zápis element.GetCustomAttribute<T>(); pre typ použite typeof(Report).
Výsledkom je zodpovedajúci atribút typu T alebo null, ak sa žiadny nenájde. Viacero zhôd vyvolá AmbiguousMatchException namiesto výberu prvého výsledku. Volanie GetCustomAttribute<Attribute> je platné a tiež vyvolá túto výnimku, ak nájde viac ako jeden zodpovedajúci atribút. Ak očakávate viacero atribútov, použite GetCustomAttributes<T>. Ak sa argument element rovná null, vyvolá sa ArgumentNullException.
Preťaženia pre MemberInfo a ParameterInfo prijímajú aj bool inherit. Hodnota false obmedzuje vyhľadávanie na atribúty použité priamo na danom prvku. Hodnota true zohľadňuje dedenie iba vtedy, ak ho daný prvok podporuje. Parameter metódy, ktorá prepisuje metódu predka, môže zdediť atribúty zo zodpovedajúceho parametra metódy predka, ale parameter konštruktora takýto reťazec dedenia nemá. Atribúty označené Inherited = false sa nededia. Príklad výslovne obmedzuje vyhľadávanie pomocou inherit: false; výsledok Monthly pochádza z LabelAttribute použitého na Report.
Príklady
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 { }
Výsledok
Monthly
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.