다음을 통해 공유

사용자 지정 특성 만들기

  • 아티클

메타데이터를 통해 특성의 정의를 빠르고 쉽게 식별할 수 있도록 해주는 Attribute로부터 직접적으로 또는 간접적으로 상속한 특성 클래스를 정의하여 사용자 지정 특성을 만들 수 있습니다. 형식을 작성한 프로그래머의 이름을 형식에 태그로 지정한다고 가정해봅시다. 사용자 지정 Author 특성 클래스를 아래와 같이 정의할 수 있습니다.

[System.AttributeUsage(System.AttributeTargets.Class |
                       System.AttributeTargets.Struct)
]
public class AuthorAttribute : System.Attribute
{
    private string Name;
    public double Version;

    public AuthorAttribute(string name)
    {
        Name = name;
        Version = 1.0;
    }
}

클래스 이름 AuthorAttribute는 특성의 이름인 Author와 Attribute 접미사입니다. System.Attribute를 상속하므로 사용자 지정 특성 클래스입니다. 생성자의 매개 변수는 사용자 지정 특성의 위치 매개 변수입니다. 이 예제에서는 name이 위치 매개 변수입니다. 모든 public 읽기-쓰기 필드 또는 속성은 명명된 매개 변수입니다. 이 경우에는 version이 유일한 명명된 매개 변수입니다. 클래스 및 struct 선언에서만 Author 특성을 유효하게 설정하려면 AttributeUsage 특성을 사용해야 합니다.

이 새로운 특성은 다음과 같이 사용할 수 있습니다.

[Author("P. Ackerman", Version = 1.1)]
class SampleClass
{
    // P. Ackerman's code goes here...
}

AttributeUsage에는 사용자 지정 특성을 한 번 또는 여러 번 사용하도록 설정하기 위해 사용하는 명명된 매개 변수인 AllowMultiple이 있습니다. 다음 코드 예제에서는 다중 사용 특성을 만듭니다.

[System.AttributeUsage(System.AttributeTargets.Class |
                       System.AttributeTargets.Struct,
                       AllowMultiple = true)  // Multiuse attribute.
]
public class AuthorAttribute : System.Attribute
{
    string Name;
    public double Version;

    public AuthorAttribute(string name)
    {
        Name = name;

        // Default value.
        Version = 1.0;
    }

    public string GetName() => Name;
}

다음 코드 예제에서는 같은 형식의 여러 특성이 한 클래스에 적용됩니다.

[Author("P. Ackerman"), Author("R. Koch", Version = 2.0)]
public class ThirdClass
{
    // ...
}

참고 항목