방법: 구성 요소에 대한 메타데이터 설명 제공

아티클
08/20/2008

업데이트: 2007년 11월

attributes을 통해 구성 요소에 대한 설명 메타데이터를 제공할 수 있습니다. 특성은 코드 요소에 적용되는 특수한 클래스로 컴파일 타임에 System.Reflection 네임스페이스를 통해 공용 언어 런타임이나 사용자 지정 도구 및 응용 프로그램에서 사용할 수 있는 메타테이터로 내보내집니다.

특성에 대한 참조를 가진 구성 요소 뒤에 관련 매개 변수 또는 플래그를 붙이는 형태로 특성이 구성 요소에 첨부됩니다. 이 생성자 호출은 Visual Basic의 경우 꺾쇠괄호(<>), C#의 경우 중괄호([]) 안에 놓입니다.

관례적으로 모든 특성 클래스는 DescriptionAttribute, ObsoleteAttribute 및 BrowsableAttribute 클래스와 같이 "Attribute"로 끝납니다. 그러나 Visual Basic 및 C#를 포함하여 공용 언어 런타임을 목표로 하는 몇 가지 언어에서는 완전한 특성 이름이 필요하지 않습니다. 예를 들어, ObsoleteAttribute는 코드에서 Obsolete로 참조할 수 있습니다.

기존 특성을 구성 요소에 첨부하려면

구성 요소에 필요한 특성을 결정합니다.
구성 요소에 특성을 첨부합니다. 정규화된 특성 이름을 사용하거나 적절한 Imports(using) 문을 추가해야 한다는 점에 유의하십시오. 다음 예제에서는 DescriptionAttribute 특성을 연결하는 방법을 보여 줍니다.
```
Imports System.ComponentModel
<Description("This is a description string")> Public Class TheClass
End Class
```
```
using System.ComponentModel;
[Description("This is a description string")]
public class TheClass
{
}
```

사용자 지정 특성

Attribute에서 상속하여 자체의 사용자 지정 도구나 응용 프로그램에서 사용할 고유 특성을 만들 수도 있습니다. 응용 프로그램에 필요한 사용자 지정 속성이나 메서드를 이 기본 클래스에 추가할 수 있습니다.

사용자 지정 특성을 만들고 적용하려면

Attribute에서 상속된 클래스를 만듭니다.

Public Class WidgetAttribute
   Inherits System.Attribute
End Class

public class WidgetAttribute: System.Attribute
{
}

특성에 필요한 속성과 메서드를 결정하고 코드를 작성합니다. 다음 예제에서는 WidgetAttribute 클래스의 생성자에 설정된 WidgetType 속성을 만드는 방법을 보여 줍니다. AttributeUsageAttribute 특성은 특성의 대상이 될 수 있는 코드 멤버를 설정합니다.

<AttributeUsage(System.AttributeTargets.Class)> Public Class _
   WidgetAttribute
   Inherits System.Attribute
   Private mWidgetType as WidgetTypeEnum
   ' Creates a readonly property for the WidgetAttribute class.
   Public ReadOnly Property WidgetType as WidgetTypeEnum
      Get
         Return mWidgetType
      End Get
   End Property
   ' Creates a constructor that accepts a parameter and assigns the 
   ' value of that parameter to the WidgetType property.
   Public Sub New(type as WidgetTypeEnum)
      MyBase.New()
      mWidgetType = type
   End Sub
End Class

[AttributeUsage(System.AttributeTargets.Class)]
public class WidgetAttribute: System.Attribute
{
   private WidgetTypeEnum widgetType;

   // Creates a readonly property for the WidgetAttribute class.
   public WidgetTypeEnum WidgetType
      {
         get {return widgetType;}
      }

   public WidgetAttribute(WidgetTypeEnum type): base()
      {
         widgetType = type;
      }
}

이 특성을 다른 특성처럼 적용하고 필요한 매개 변수를 적용합니다.

<WidgetAttribute(WidgetTypeEnum.VerticalWidget)> _
   Public Class WidgetFortyFive
End Class

[WidgetAttribute(WidgetTypeEnum.VerticalWidget)]
public class WidgetFortyFive
{
}

참고 항목

다음을 통해 공유

방법: 구성 요소에 대한 메타데이터 설명 제공

기존 특성을 구성 요소에 첨부하려면

사용자 지정 특성

사용자 지정 특성을 만들고 적용하려면

참고 항목

작업

개념

참조

기타 리소스

추가 리소스