Acessar atributos usando reflexão

O fato de que você pode definir atributos personalizados e colocá-los em seu código-fonte seria de pouco valor sem alguma maneira de recuperar essas informações e agir sobre elas. Usando reflexão, você pode recuperar as informações que foram definidas com atributos personalizados. O método de chave é GetCustomAttributes, que retorna uma matriz de objetos que são os equivalentes em tempo de execução dos atributos de código-fonte. Esse método tem muitas versões sobrecarregadas. Para obter mais informações, consulte Attribute.

Uma especificação de atributo como:

[Author("P. Ackerman", Version = 1.1)]
class SampleClass { }

é conceitualmente equivalente ao seguinte código:

var anonymousAuthorObject = new Author("P. Ackerman")
{
    Version = 1.1
};

No entanto, o código não é executado até que SampleClass seja consultado quanto a atributos. Chamar GetCustomAttributes em SampleClass faz com que um objeto Author seja construído e inicializado. Se a classe tiver outros atributos, outros objetos de atributo serão construídos da mesma forma. GetCustomAttributes em seguida, retorna o Author objeto e quaisquer outros objetos de atributo em uma matriz. Em seguida, você pode iterar sobre essa matriz, determinar quais atributos foram aplicados com base no tipo de cada elemento de matriz e extrair informações dos objetos de atributo.

Aqui está um exemplo completo. Um atributo personalizado é definido, aplicado a várias entidades e recuperado por meio de reflexão.

// Multiuse attribute.
[System.AttributeUsage(System.AttributeTargets.Class |
                       System.AttributeTargets.Struct,
                       AllowMultiple = true)  // Multiuse attribute.
]
public class AuthorAttribute : System.Attribute
{
    string Name;
    public string Version;

    public AuthorAttribute(string name)
    {
        Name = name;

        // Default value.
        Version = "1.0";
    }

    public string GetName() => Name;
}

// Class with the Author attribute.
[Author("P. Ackerman")]
public class FirstClass
{
    // ...
}

// Class without the Author attribute.
public class SecondClass
{
    // ...
}

// Class with multiple Author attributes.
[Author("P. Ackerman"), Author("R. Koch", Version = "2.0")]
public class ThirdClass
{
    // ...
}

class TestAuthorAttribute
{
    public static void Test()
    {
        PrintAuthorInfo(typeof(FirstClass));
        PrintAuthorInfo(typeof(SecondClass));
        PrintAuthorInfo(typeof(ThirdClass));
    }

    private static void PrintAuthorInfo(System.Type t)
    {
        System.Console.WriteLine($"Author information for {t}");

        // Using reflection.
        System.Attribute[] attrs = System.Attribute.GetCustomAttributes(t);  // Reflection.

        // Displaying output.
        foreach (System.Attribute attr in attrs)
        {
            if (attr is AuthorAttribute a)
            {
                System.Console.WriteLine($"   {a.GetName()}, version {a.Version}");
            }
        }
    }
}
/* Output:
    Author information for FirstClass
       P. Ackerman, version 1.0
    Author information for SecondClass
    Author information for ThirdClass
       R. Koch, version 2.0
       P. Ackerman, version 1.0
*/

Consulte também

  • Última atualização em