Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

GetCustomAttribute<T> — načtení jednoho atributu

CustomAttributeExtensions.GetCustomAttribute<T> načte pomocí reflexe jeden atribut typu T. Seznamte se s podporovanými cíli, zpracováním hodnoty null a důvodem, proč více shod vyvolá výjimku.

Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

public static T? GetCustomAttribute<T>(this System.Reflection.MemberInfo element, bool inherit) where T : Attribute;

CustomAttributeExtensions.GetCustomAttribute<T> v System.Reflection poskytuje rozšiřující metody pro MemberInfo, ParameterInfo, Assembly a Module. Typem T může být samotný System.Attribute nebo typ z něj odvozený. Import using System.Reflection; umožňuje zápis element.GetCustomAttribute<T>(); pro typ použijte typeof(Report).

Výsledkem je odpovídající atribut typu T, nebo null, pokud se žádný nenajde. Více shod vyvolá AmbiguousMatchException namísto výběru prvního výsledku. Volání GetCustomAttribute<Attribute> je platné a také vyvolá tuto výjimku, pokud najde více než jeden odpovídající atribut. Pokud očekáváte více atributů, použijte GetCustomAttributes<T>. Je-li argument element roven null, vyvolá se ArgumentNullException.

Přetížení pro MemberInfo a ParameterInfo přijímají také bool inherit. Hodnota false omezuje hledání na atributy použité přímo na daném prvku. Hodnota true zohledňuje dědičnost jen tehdy, když ji daný prvek podporuje. Parametr metody, která přepisuje metodu předka, může zdědit atributy z odpovídajícího parametru metody předka, ale parametr konstruktoru takový řetězec dědičnosti nemá. Atributy označené Inherited = false se nedědí. Příklad výslovně omezuje hledání pomocí inherit: false; výsledek Monthly pochází z LabelAttribute použitého na Report.

Pří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ýsledek

Monthly

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje