Compartilhar via

Acessar atributos personalizados

Depois que os atributos tiverem sido associados aos elementos do programa, a reflexão poderá ser usada para consultar sua existência e valores. O .NET fornece o MetadataLoadContext. que você pode usar para examinar o código que não pode ser carregado para execução.

MetadataLoadContext

O código carregado no MetadataLoadContext contexto não pode ser executado. Isso significa que não é possível criar instâncias de atributos personalizados, pois isso exigiria a execução de seus construtores. Para carregar e examinar atributos personalizados no MetadataLoadContext contexto, use a CustomAttributeData classe. Você pode obter instâncias dessa classe usando a sobrecarga apropriada do método estático CustomAttributeData.GetCustomAttributes . Para obter mais informações, consulte Como inspecionar o conteúdo do assembly usando MetadataLoadContext.

O contexto de execução

Os principais métodos de reflexão para consultar atributos no contexto de execução são MemberInfo.GetCustomAttributes e Attribute.GetCustomAttributes.

A acessibilidade de um atributo personalizado é verificada em relação ao assembly no qual ele está anexado. Isso equivale a verificar se um método em um tipo no assembly no qual o atributo personalizado está anexado pode chamar o construtor do atributo personalizado.

Métodos como Assembly.GetCustomAttributes(Boolean) verificam a visibilidade e a acessibilidade do argumento de tipo. Somente o código no assembly que contém o tipo definido pelo usuário pode recuperar um atributo personalizado desse tipo usando GetCustomAttributes.

O exemplo de C# a seguir é um padrão típico de design de atributo personalizado. Ele ilustra o modelo de reflexão de atributo personalizado em tempo de execução.

System.DLL
public class DescriptionAttribute : Attribute
{
}

System.Web.DLL
internal class MyDescriptionAttribute : DescriptionAttribute
{
}

public class LocalizationExtenderProvider
{
    [MyDescriptionAttribute(...)]
    public CultureInfo GetLanguage(...)
    {
    }
}

Se o runtime estiver tentando recuperar os atributos personalizados para o tipo DescriptionAttribute de atributo personalizado público anexado ao GetLanguage método, ele executará as seguintes ações:

  1. O runtime verifica se o argumento de tipo DescriptionAttribute para Type.GetCustomAttributes(Type type) é público e, portanto, está visível e acessível.
  2. O tempo de execução verifica se o tipo MyDescriptionAttribute definido pelo usuário derivado de DescriptionAttribute é visível e acessível dentro do assembly System.Web.dll, ao qual está anexado ao método GetLanguage().
  3. O runtime verifica se o construtor MyDescriptionAttribute está visível e acessível dentro do assembly System.Web.dll.
  4. O runtime chama o construtor de MyDescriptionAttribute com os parâmetros de atributos personalizados e retorna o novo objeto para o chamador.

O modelo de reflexão de atributo personalizado pode vazar instâncias de tipos definidos pelo usuário fora do assembly no qual o tipo é definido. Isso não é diferente dos membros na biblioteca do sistema de runtime que retornam instâncias de tipos definidos pelo usuário, como Type.GetMethods o retorno de uma matriz de RuntimeMethodInfo objetos. Para impedir que um cliente descubra informações sobre um tipo de atributo personalizado definido pelo usuário, defina os membros do tipo como não públicos.

O exemplo a seguir demonstra a maneira básica de usar a reflexão para obter acesso a atributos personalizados.

using System;

public class ExampleAttribute : Attribute
{
    private string stringVal;

    public ExampleAttribute()
    {
        stringVal = "This is the default string.";
    }

    public string StringValue
    {
        get { return stringVal; }
        set { stringVal = value; }
    }
}

[Example(StringValue="This is a string.")]
class Class1
{
    public static void Main()
    {
        System.Reflection.MemberInfo info = typeof(Class1);
        foreach (object attrib in info.GetCustomAttributes(true))
        {
            Console.WriteLine(attrib);
        }
    }
}

Public Class ExampleAttribute
    Inherits Attribute

    Private stringVal As String

    Public Sub New()
        stringVal = "This is the default string."
    End Sub

    Public Property StringValue() As String
        Get
            Return stringVal
        End Get
        Set(Value As String)
            stringVal = Value
        End Set
    End Property
End Class

<Example(StringValue:="This is a string.")> _
Class Class1
    Public Shared Sub Main()
        Dim info As System.Reflection.MemberInfo = GetType(Class1)
        For Each attrib As Object In info.GetCustomAttributes(true)
            Console.WriteLine(attrib)
        Next attrib
    End Sub
End Class

Consulte também

  • Last updated on