Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

GetCustomAttribute<T> — čitanje jednog atributa

CustomAttributeExtensions.GetCustomAttribute<T> dohvaća refleksijom jedan atribut tipa T. Saznajte koji su ciljevi podržani, kako se obrađuje null i zašto više podudaranja uzrokuje iznimku.

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

Sintaksa

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

CustomAttributeExtensions.GetCustomAttribute<T> u System.Reflection pruža metode proširenja za MemberInfo, ParameterInfo, Assembly i Module. T može biti sam System.Attribute ili tip izveden iz njega. Uvoz using System.Reflection; omogućuje zapis element.GetCustomAttribute<T>(); za tip upotrijebite typeof(Report).

Rezultat je odgovarajući atribut tipa T ili null ako nijedan nije pronađen. Više podudaranja uzrokuje AmbiguousMatchException umjesto odabira prvog rezultata. Poziv GetCustomAttribute<Attribute> valjan je i također baca tu iznimku ako pronađe više od jednog odgovarajućeg atributa. Ako očekujete više atributa, upotrijebite GetCustomAttributes<T>. Ako je argument element jednak null, pokreće se ArgumentNullException.

Preopterećenja za MemberInfo i ParameterInfo prihvaćaju i bool inherit. Vrijednost false ograničava pretraživanje na atribute primijenjene izravno na ciljni element. Vrijednost true uzima u obzir nasljeđivanje samo ako ga ciljni element podržava. Parametar metode koja nadjačava metodu bazne klase može naslijediti atribute odgovarajućeg parametra metode bazne klase, ali parametar konstruktora nema takav lanac nasljeđivanja. Atributi označeni s Inherited = false ne nasljeđuju se. Primjer izričito ograničava pretraživanje pomoću inherit: false; rezultat Monthly potječe od atributa LabelAttribute primijenjenog na Report.

Primjeri

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 { }

Rezultat

Monthly

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori