CustomAttribute 구조체

정의

사용자 지정 특성에 대한 정보를 제공합니다.

public value class CustomAttribute
public struct CustomAttribute
type CustomAttribute = struct
Public Structure CustomAttribute
상속
CustomAttribute

예제

이 예제에서는 형식 정의에 적용된 모든 사용자 지정 특성을 인쇄하는 방법을 보여줍니다.

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

설명

사용자 지정 특성은 추가 정보를 어셈블리, 형식 또는 메서드와 같은 메타데이터 요소와 연결하는 주석입니다. 이 메서드를 GetCustomAttribute(CustomAttributeHandle) 사용하여 사용자 지정 특성 인스턴스를 가져올 수 있습니다. .NET 특성에 대한 자세한 내용은 특성을 사용하여 메타데이터를 확장 참조하세요.

속성

Name Description
Constructor

사용자 지정 특성 형식의 MethodDefinitionHandle 생성자(또는 MemberReferenceHandle)를 가져옵니다.

Parent

특성이 적용되는 메타데이터 엔터티의 핸들을 가져옵니다.

Value

특성의 값을 가져옵니다.

적용 대상