Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C#

GetCustomAttribute<T> — leer un único atributo

CustomAttributeExtensions.GetCustomAttribute<T> obtiene mediante reflexión un único atributo de tipo T. Descubre los destinos compatibles, cómo se gestiona null y por qué varias coincidencias provocan una excepción.

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

Sintaxis

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

CustomAttributeExtensions.GetCustomAttribute<T> de System.Reflection proporciona métodos de extensión para MemberInfo, ParameterInfo, Assembly y Module. T puede ser el propio System.Attribute o un tipo derivado de él. La importación using System.Reflection; permite escribir element.GetCustomAttribute<T>(); para un tipo, usa typeof(Report).

El resultado es un atributo coincidente de tipo T o null si no se encuentra ninguno. Varias coincidencias provocan AmbiguousMatchException, en lugar de seleccionar el primer resultado. La llamada a GetCustomAttribute<Attribute> es válida y también lanza esta excepción si coincide más de un atributo. Si esperas varios atributos, usa GetCustomAttributes<T>. Si el argumento element es null, se produce ArgumentNullException.

Las sobrecargas para MemberInfo y ParameterInfo también aceptan bool inherit. Con false, la búsqueda se limita a los atributos aplicados directamente al destino. Con true, solo se tiene en cuenta la herencia si el destino la admite. Un parámetro de un método que sobrescribe un método base puede heredar atributos del parámetro correspondiente del método base, pero un parámetro de constructor no tiene esa cadena de herencia. Los atributos marcados con Inherited = false no se heredan. El ejemplo limita explícitamente la búsqueda con inherit: false; el resultado Monthly procede de LabelAttribute, aplicado a Report.

Ejemplos

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

Resultado

Monthly

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes