CustomAttribute Struktúra

Definíció

Névtér:

System.Reflection.Metadata

Szerelvény:

System.Reflection.Metadata.dll

Csomag:

System.Reflection.Metadata v11.0.0-preview.5.26302.115

Forrás:

CustomAttribute.cs

Információt nyújt egy egyéni attribútumról.

public value class CustomAttribute

public readonly struct CustomAttribute

type CustomAttribute = struct

Public Structure CustomAttribute

Öröklődés

Object

ValueType

CustomAttribute

Példák

Ez a példa bemutatja, hogyan nyomtathatja ki a típusdefinícióra alkalmazott összes egyéni attribútumot:

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

Megjegyzések

Az egyéni attribútumok olyan széljegyzetek, amelyek további információkat társítanak egy metaadatelemhez, például szerelvényhez, típushoz vagy metódushoz. A metódussal GetCustomAttribute(CustomAttributeHandle) egyéni attribútumpéldányt kérhet le. A .NET attribútumairól további információt a A metaadatok attribútumok használatával című témakörben talál.

Tulajdonságok

Name	Description
Constructor	Lekéri az egyéni attribútumtípus konstruktorát ( MethodDefinitionHandle vagy MemberReferenceHandle)
Parent	Lekéri annak a metaadat-entitásnak a leíróját, amelyre az attribútum vonatkozik.
Value	Lekéri az attribútum értékét.

Metódusok

Name	Description
DecodeValue<TType>(ICustomAttributeTypeProvider<TType>)	Az értékblobban kódolt argumentumokat dekódolja.