CustomAttribute Struktura

Definice

Obor názvů:

System.Reflection.Metadata

Sestavení:

System.Reflection.Metadata.dll

Zdroj:

CustomAttribute.cs

Poskytuje informace o vlastním atributu.

public value class CustomAttribute

public readonly struct CustomAttribute

type CustomAttribute = struct

Public Structure CustomAttribute

Dědičnost

Object

ValueType

CustomAttribute

Příklady

Tento příklad ukazuje, jak vytisknout všechny vlastní atributy použité na definici typu:

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);
    }
}

Poznámky

Vlastní atribut je poznámka, která přidružuje další informace k elementu metadat, jako je sestavení, typ nebo metoda. Pomocí metody můžete GetCustomAttribute(CustomAttributeHandle) získat instanci vlastního atributu. Další informace o atributech v .NET najdete v tématu Rozšíření metadat pomocí atributů.

Vlastnosti

Name	Description
Constructor	Získá konstruktor (nebo MethodDefinitionHandleMemberReferenceHandle) vlastního typu atributu.
Parent	Získá popisovač metadat entity atributu je použit.
Value	Získá hodnotu atributu.

Metody

Name	Description
DecodeValue<TType>(ICustomAttributeTypeProvider<TType>)	Dekóduje argumenty zakódované v objektu blob hodnoty.