CustomAttribute Yapı

Tanım

Ad Alanı:

System.Reflection.Metadata

Bütünleştirilmiş Kod:

System.Reflection.Metadata.dll

Paket:

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

Kaynak:

CustomAttribute.cs

Özel öznitelik hakkında bilgi sağlar.

public value class CustomAttribute

public readonly struct CustomAttribute

type CustomAttribute = struct

Public Structure CustomAttribute

Devralma

Object

ValueType

CustomAttribute

Örnekler

Bu örnek, tür tanımına uygulanan tüm özel özniteliklerin nasıl yazdırılacağını gösterir:

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

Açıklamalar

Özel öznitelik, derleme, tür veya yöntem gibi ek bilgileri meta veri öğesiyle ilişkilendiren bir ek açıklamadır. Özel bir öznitelik örneği almak için yöntemini kullanabilirsiniz GetCustomAttribute(CustomAttributeHandle) . .NET öznitelikleri hakkında daha fazla bilgi için bkz. öznitelikleri kullanarak Extend meta verileri.

Özellikler

Name	Description
Constructor	Özel öznitelik türünün oluşturucusunu MethodDefinitionHandle (veya MemberReferenceHandle) alır.
Parent	Özniteliğin uygulandığı meta veri varlığının tutamacını alır.
Value	özniteliğinin değerini alır.

Yöntemler

Name	Description
DecodeValue<TType>(ICustomAttributeTypeProvider<TType>)	Değer blobunda kodlanmış bağımsız değişkenlerin kodunu çözer.