Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje