다음을 통해 공유


사용자 지정 특성 만들기(C# 및 Visual Basic)

Attribute에서 직접 또는 간접적으로 파생된 클래스인 특성 클래스를 정의하여 고유한 사용자 지정 특성을 만들 수 있습니다. 이러한 파생으로 인해 특성 정의를 메타데이터에서 쉽고 빠르게 식별할 수 있습니다.형식을 작성한 프로그래머의 이름으로 형식에 태그를 지정한다고 가정합니다.다음과 같은 사용자 지정 Author 특성 클래스를 정의합니다.

<System.AttributeUsage(System.AttributeTargets.Class Or 
                       System.AttributeTargets.Struct)> 
Public Class Author
    Inherits System.Attribute
    Private name As String
    Public version As Double
    Sub New(ByVal authorName As String)
        name = authorName
        version = 1.0
    End Sub
End Class
[System.AttributeUsage(System.AttributeTargets.Class |
                       System.AttributeTargets.Struct)
]
public class Author : System.Attribute
{
    private string name;
    public double version;

    public Author(string name)
    {
        this.name = name;
        version = 1.0;
    }
}

클래스 이름은 특성 이름인 Author입니다.이 클래스는 System.Attribute에서 파생되었으므로 사용자 지정 특성 클래스입니다.생성자의 매개 변수는 사용자 지정 특성의 위치 매개 변수입니다.이 예제에서는 name이 위치 매개 변수입니다.public 읽기/쓰기 필드나 속성은 모두 명명된 매개 변수입니다.이 경우 version이 유일한 명명된 매개 변수입니다.AttributeUsage 특성을 사용하면 struct(Visual Basic의 경우 Structure) 선언 및 클래스에서만 Author 특성이 유효해집니다.

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

<Author("P. Ackerman", Version:=1.1)> 
Class SampleClass
    ' P. Ackerman's code goes here...
End Class
[Author("P. Ackerman", version = 1.1)]
class SampleClass
{
    // P. Ackerman's code goes here...
}

AttributeUsage에는 명명된 매개 변수인 AllowMultiple이 있습니다. 이 매개 변수를 통해 사용자 지정 특성을 단일 사용 또는 다중 사용으로 설정할 수 있습니다.다음 코드 예제에서는 다용도 특성이 만들어집니다.

' multiuse attribute
<System.AttributeUsage(System.AttributeTargets.Class Or 
                       System.AttributeTargets.Struct, 
                       AllowMultiple:=True)> 
Public Class Author
    Inherits System.Attribute
[System.AttributeUsage(System.AttributeTargets.Class |
                       System.AttributeTargets.Struct,
                       AllowMultiple = true)  // multiuse attribute
]
public class Author : System.Attribute

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

<Author("P. Ackerman", Version:=1.1), 
Author("R. Koch", Version:=1.2)> 
Class SampleClass
    ' P. Ackerman's code goes here...
    ' R. Koch's code goes here...
End Class
[Author("P. Ackerman", version = 1.1)]
[Author("R. Koch", version = 1.2)]
class SampleClass
{
    // P. Ackerman's code goes here...
    // R. Koch's code goes here...
}

[!참고]

특성 클래스에 속성이 포함된 경우 해당 속성은 읽기/쓰기 속성이어야 합니다.

참고 항목

참조

리플렉션(C# 및 Visual Basic)

특성(C# 및 Visual Basic)

리플렉션을 사용하여 특성 액세스(C# 및 Visual Basic)

System.Reflection

AttributeUsage(C# 및 Visual Basic)

개념

C# 프로그래밍 가이드

사용자 지정 특성 작성

기타 리소스

Visual Basic 프로그래밍 가이드