CustomAttribute Estructura

Definición

Espacio de nombres:

System.Reflection.Metadata

Ensamblado:

System.Reflection.Metadata.dll

Source:

CustomAttribute.cs

Proporciona información sobre un atributo personalizado.

public value class CustomAttribute

public readonly struct CustomAttribute

type CustomAttribute = struct

Public Structure CustomAttribute

Herencia

Object

ValueType

CustomAttribute

Ejemplos

En este ejemplo se muestra cómo imprimir todos los atributos personalizados aplicados a la definición de tipo:

class MyAttribute : Attribute
{
    public int X { get; set; }
}

[My(X = 1)]
class ExampleType1 { }

[My(X = 2)]
class ExampleType2 { }

static void PrintCustomAttributes(MetadataReader mr, TypeDefinition t)
{
    // Enumerate custom attributes on the type definition
    foreach (CustomAttributeHandle attrHandle in t.GetCustomAttributes())
    {
        CustomAttribute attr = mr.GetCustomAttribute(attrHandle);

        // Display the attribute type full name
        if (attr.Constructor.Kind == HandleKind.MethodDefinition)
        {
            MethodDefinition mdef = mr.GetMethodDefinition((MethodDefinitionHandle)attr.Constructor);
            TypeDefinition tdef = mr.GetTypeDefinition(mdef.GetDeclaringType());
            Console.WriteLine($"Type:  {mr.GetString(tdef.Namespace)}.{mr.GetString(tdef.Name)}");
        }
        else if (attr.Constructor.Kind == HandleKind.MemberReference)
        {
            MemberReference mref = mr.GetMemberReference((MemberReferenceHandle)attr.Constructor);

            if (mref.Parent.Kind == HandleKind.TypeReference)
            {
                TypeReference tref = mr.GetTypeReference((TypeReferenceHandle)mref.Parent);
                Console.WriteLine($"Type:  {mr.GetString(tref.Namespace)}.{mr.GetString(tref.Name)}");
            }
            else if (mref.Parent.Kind == HandleKind.TypeDefinition)
            {
                TypeDefinition tdef = mr.GetTypeDefinition((TypeDefinitionHandle)mref.Parent);
                Console.WriteLine($"Type:  {mr.GetString(tdef.Namespace)}.{mr.GetString(tdef.Name)}");
            }
        }

        // Display the attribute value
        byte[] data = mr.GetBlobBytes(attr.Value);
        Console.Write("Value: ");

        for (int i = 0; i < data.Length; i++) Console.Write($"{data[i]:X2} ");

        Console.WriteLine();
    }
}

static void PrintTypesCustomAttributes(MetadataReader mr)
{
    foreach (TypeDefinitionHandle tdh in mr.TypeDefinitions)
    {
        TypeDefinition t = mr.GetTypeDefinition(tdh);
        Console.WriteLine($"{mr.GetString(t.Namespace)}.{mr.GetString(t.Name)}");
        PrintCustomAttributes(mr, t);
    }
}

Comentarios

Un atributo personalizado es una anotación que asocia información adicional a un elemento de metadatos, como un ensamblado, un tipo o un método. Puede usar el GetCustomAttribute(CustomAttributeHandle) método para obtener una instancia de atributo personalizada. Para obtener más información sobre los atributos de .NET, consulte Extensión de metadatos mediante atributos.

Propiedades

Constructor	Obtiene el constructor (MethodDefinitionHandle o MemberReferenceHandle) del tipo de atributo personalizado.
Parent	Obtiene el controlador de la entidad de los metadatos donde se aplica el atributo.
Value	Obtiene el valor del atributo.

Métodos

DecodeValue<TType>(ICustomAttributeTypeProvider<TType>)

Descodifica los argumentos codificados en el blob del valor.