다음을 통해 공유


CustomAttribute 구조체

정의

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

public value class CustomAttribute
public struct CustomAttribute
public readonly 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) 사용하여 사용자 지정 특성 instance 가져올 수 있습니다. .NET의 특성에 대한 자세한 내용은 특성을 사용하여 메타데이터 확장을 참조하세요.

속성

Constructor

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

Parent

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

Value

특성 값을 얻습니다.

메서드

DecodeValue<TType>(ICustomAttributeTypeProvider<TType>)

값 Blob에 인코딩된 인수를 디코딩합니다.

적용 대상