コンポーネントのデザイン時属性

更新 : 2007 年 11 月

属性を適用して共通言語ランタイムにメタデータを用意する方法がわからない場合は、「属性を使用したメタデータの拡張」を参照してください。コンポーネントは Visual Studio などのデザイナに表示できるため、コンポーネントにはデザイン時ツールにメタデータを与える属性が必要です。このセクションでは、一般的に使用されるデザイン時属性について説明し、それらの属性のリストを示します。

属性とデザイナのサポート

デザイン時属性は、ビジュアル デザイン ツールに対して重要な情報を提供するので、デザイン時にコントロールとそのメンバを正しく表示するためにはこれらの属性が不可欠です。

CategoryAttribute 属性を使って、プロパティ ブラウザに Alignment カテゴリの TextAlignment プロパティを表示するコード片を次に示します。DescriptionAttribute 属性は、ユーザーがプロパティをクリックしたときに、そのプロパティの簡単な説明をプロパティ ブラウザに表示するために使用されます。

[
Category("Alignment"),
Description("Specifies the alignment of text.")
]
public ContentAlignment TextAlignment { //... }

<Category("Alignment"), _
Description("Specifies the alignment of text.")> _
Public Property _
TextAlignment As ContentAlignment
   ' ...
End Property

メモ :
Visual C# および Visual Basic では、AttributeNameAttribute という名前の属性クラスは、属性構文では簡単に AttributeName と記述できます。

デザイン時属性の中には、クラス レベルで適用されるものがあります。DesignerAttribute 属性はクラス レベルで適用され、コントロールの表示に使用するデザイナ クラスをフォーム デザイナに通知します。コンポーネントは既定のデザイナ (System.ComponentModel.Design.ComponentDesigner) に関連付けられ、Windows フォームおよび ASP.NET サーバー コントロールは、それら自身の既定のデザイナに関連付けられます。DesignerAttribute は、コンポーネントまたはコントロールに対してカスタム デザイナを定義する場合にだけ適用してください。

// Associates the designer class SimpleControl.Design.SimpleDesigner
// with Simple.
[ Designer(typeof(SimpleControl.Design.SimpleDesigner))]
    public class Simple : WebControl { //... }

' Associates the designer class SimpleControl.Design.SimpleDesigner
' with Simple.
<Designer(GetType(SimpleControl.Design.SimpleDesigner))> _
Public Class Simple
    Inherits WebControl
    ' ...
End Class

プロパティとイベントに共通の属性

プロパティとイベントに共通に適用される属性のリストを次の表に示します。

特に指定がない限り、プロパティとイベントの属性は、次の例に示すように、コード内でプロパティまたはイベント宣言の直前に記述します。

// To apply CategoryAttribute to the BorderColor 
// property, place it immediately before the declaration
// of the BorderColor property.
[Category("Appearance")] 
public Color BorderColor;

// To apply DescriptionAttribute to the Click event, 
// place it immediately before the declaration
// of the Click event.
[Description("The Click event of the button")]
public event EventHandler Click;

' To apply CategoryAttribute  to the BorderColor 
' property, place it before the property declaration.
<Category("Appearance")> Public BorderColor As Color

' To apply DescriptionAttribute to the Click event, 
' place it before the event declaration.
<Description("The Click event of the button")> Public Event Click

デザイナと、コンポーネントおよびコントロールとを関連付けるデザイン時属性については、「デザイン時サポートの拡張」を参照してください。

.NET Framework クラス ライブラリで定義されている属性クラスを使用する他に、独自の属性クラスを定義することもできます。詳細については、使用するプログラミング言語のドキュメントを参照するか、または「カスタム属性の記述」を参照してください。

参照

処理手順

方法 : Windows フォーム コントロールに属性を適用する

概念

属性とデザイン時サポート

Windows フォーム コントロールの属性

その他の技術情報

デザイン時サポートの拡張