CategoryAttribute

.NET Framework クラス ライブラリ リファレンス

CategoryAttribute クラス

PropertyGrid コントロールが [項目別] モードに設定されているときに、コントロールに表示するプロパティまたはイベントを分類するカテゴリの名前を指定します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

<AttributeUsageAttribute(AttributeTargets.All)> _
Public Class CategoryAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As CategoryAttribute

C#

[AttributeUsageAttribute(AttributeTargets.All)] 
public class CategoryAttribute : Attribute

C++

[AttributeUsageAttribute(AttributeTargets::All)] 
public ref class CategoryAttribute : public
 Attribute

J#

/** @attribute AttributeUsageAttribute(AttributeTargets.All) */ 
public class CategoryAttribute extends Attribute

JScript

AttributeUsageAttribute(AttributeTargets.All) 
public class CategoryAttribute extends
 Attribute

解説

CategoryAttribute は、PropertyGrid コントロールが Categorized モードに設定されているときに、コントロールに表示するプロパティまたはイベントを関連付けるカテゴリを示します。CategoryAttribute を適用しないプロパティまたはイベントは、PropertyGrid によって Misc カテゴリに関連付けられます。CategoryAttribute のコンストラクタにカテゴリ名を指定することにより、任意の名前でカテゴリを新規作成できます。

Category プロパティは、属性に対応するカテゴリの名前を示します。Category プロパティは、カテゴリ名の透過なローカリゼーションも提供します。

継承時の注意 定義済みの名前以外のカテゴリ名を使用し、カテゴリ名をローカライズする場合は、GetLocalizedString メソッドをオーバーライドする必要があります。また、ローカリゼーションに独自のロジックを採用する場合は、Category プロパティをオーバーライドできます。 CategoryAttribute クラスは、次の共通カテゴリを定義します。

カテゴリ	説明
Action	実行できるアクションに関連するプロパティ。
Appearance	エンティティの外観に関連するプロパティ。
Behavior	エンティティの動作に関連するプロパティ。
Data	データおよびデータ ソース管理に関連するプロパティ。
Default	既定カテゴリに分類されるプロパティ。
Design	デザイン時だけ使用できるプロパティ。
DragDrop	ドラッグ アンド ドロップ操作に関連するプロパティ。
Focus	フォーカスに関連するプロパティ。
Format	書式指定に関連するプロパティ。
Key	キーボードに関連するプロパティ。
Layout	レイアウトに関連するプロパティ。
Mouse	マウスに関連するプロパティ。
WindowStyle	トップ レベル フォームのウィンドウ スタイルに関連するプロパティ。

詳細については、属性の概要、属性を使用したメタデータの拡張 の各トピックを参照してください。

Topic	Location
チュートリアル : カスタム サーバー コントロールの開発と使用	ASP.NET コントロールの作成

使用例

MyImage プロパティを作成する例を次に示します。このプロパティには、DescriptionAttribute と CategoryAttribute の 2 つの属性があります。

Visual Basic

<Description("The image associated with the control"),
 _
    Category("Appearance")> _
Public Property MyImage() As
 Image
    
    Get
        ' Insert code here.
        Return image1
    End Get
    Set
        ' Insert code here.
    End Set 
End Property

C#

[Description("The image associated with the control"),Category("Appearance")]
 
 public Image MyImage {
    get {
       // Insert code here.
       return image1;
    }
    set {
       // Insert code here.
    }
 }

C++

   [Description("The image associated with the control"),Category("Appearance")]
   System::Drawing::Image^ get()
   {
      // Insert code here.
      return m_Image1;
   }

   void set( System::Drawing::Image^ )
   {
      // Insert code here.
   }
}

J#

/** @attribute Description("The image associated with the control")
  * @attribute Category("Appearance")
 */
/** @property 
 */
public Image get_MyImage()
{
    // Insert code here.
    return image1;
} //get_MyImage

/** @property 
 */
public void set_MyImage(Image value)
{
    // Insert code here.
} //set_MyImage

MyImage のカテゴリを取得する例を次に示します。最初に、オブジェクトのすべてのプロパティを保持する PropertyDescriptorCollection を取得します。次に、PropertyDescriptorCollection にインデックスを付けて、MyImage を取得します。そして、このプロパティの属性を返し、その属性を変数 attributes に保存します。

最後に、AttributeCollection から CategoryAttribute を取得し、取得した情報をコンソール画面に書き込むことによって、カテゴリを出力します。

Visual Basic

' Gets the attributes for the property.
Dim attributes As AttributeCollection = _
    TypeDescriptor.GetProperties(Me)("MyImage").Attributes

' Prints the description by retrieving the CategoryAttribute. 
' from the AttributeCollection.
Dim myAttribute As CategoryAttribute = _
    CType(attributes(GetType(CategoryAttribute)), CategoryAttribute)
    Console.WriteLine(myAttribute.Category)

C#

// Gets the attributes for the property.
 AttributeCollection attributes = 
    TypeDescriptor.GetProperties(this)["MyImage"].Attributes;
 
 // Prints the description by retrieving the CategoryAttribute.
 // from the AttributeCollection.
 CategoryAttribute myAttribute = 
    (CategoryAttribute)attributes[typeof(CategoryAttribute)];
 Console.WriteLine(myAttribute.Category);

C++

// Gets the attributes for the property.
AttributeCollection^ attributes = TypeDescriptor::GetProperties( this
 )[ "MyImage" ]->Attributes;

// Prints the description by retrieving the CategoryAttribute.
// from the AttributeCollection.
CategoryAttribute^ myAttribute = static_cast<CategoryAttribute^>(attributes[
 CategoryAttribute::typeid ]);
Console::WriteLine( myAttribute->Category );

J#

// Gets the attributes for the property.
AttributeCollection attributes = TypeDescriptor.GetProperties(this)
    .get_Item("MyImage").get_Attributes();

// Prints the description by retrieving the CategoryAttribute.
// from the AttributeCollection.
CategoryAttribute myAttribute = (CategoryAttribute)(
    attributes.get_Item(CategoryAttribute.class.ToType()));
Console.WriteLine(myAttribute.get_Category());

継承階層

System.Object
   System.Attribute
    System.ComponentModel.CategoryAttribute

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
CategoryAttribute メンバ
System.ComponentModel 名前空間
Attribute
PropertyDescriptor
EventDescriptor

CategoryAttribute コンストラクタ ()

Default というカテゴリ名を使用して、CategoryAttribute クラスの新しいインスタンスを初期化します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New CategoryAttribute

C#

public CategoryAttribute ()

C++

public:
CategoryAttribute ()

J#

public CategoryAttribute ()

JScript

public function CategoryAttribute ()

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
CategoryAttribute クラス
CategoryAttribute メンバ
System.ComponentModel 名前空間

CategoryAttribute コンストラクタ (String)

指定したカテゴリ名を使用して、CategoryAttribute クラスの新しいインスタンスを初期化します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    category As String _
)

Visual Basic (使用法)

Dim category As String

Dim instance As New CategoryAttribute(category)

C#

public CategoryAttribute (
    string category
)

C++

public:
CategoryAttribute (
    String^ category
)

J#

public CategoryAttribute (
    String category
)

JScript

public function CategoryAttribute (
    category : String
)

パラメータ

category

カテゴリの名前。

解説

category パラメータに指定した名前が定義済みのカテゴリ名の場合、その名前は Category プロパティによって自動的にローカライズされます。

指定した名前が定義済みのカテゴリ名ではない場合、および GetLocalizedString メソッドをオーバーライドしてローカライズ後の名前を指定しない場合、その名前はローカライズされません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
CategoryAttribute クラス
CategoryAttribute メンバ
System.ComponentModel 名前空間

CategoryAttribute コンストラクタ

CategoryAttribute クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
CategoryAttribute ()	Default というカテゴリ名を使用して、CategoryAttribute クラスの新しいインスタンスを初期化します。
CategoryAttribute (String)	指定したカテゴリ名を使用して、CategoryAttribute クラスの新しいインスタンスを初期化します。

参照

関連項目

CategoryAttribute クラス
CategoryAttribute メンバ
System.ComponentModel 名前空間

CategoryAttribute プロパティ

パブリック プロパティ

	名前	説明
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。 ( Attribute から継承されます。)
	WindowStyle	WindowStyle カテゴリを表す CategoryAttribute を取得します。

参照

関連項目

CategoryAttribute クラス
System.ComponentModel 名前空間
Attribute
PropertyDescriptor
EventDescriptor

CategoryAttribute メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 オーバーライドされます。 指定したオブジェクトの値が現在の CategoryAttribute と等しいかどうかを示す値を返します。
	GetCustomAttribute	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 ( Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 ( Attribute から継承されます。)
	GetHashCode	オーバーライドされます。 この属性のハッシュ コードを返します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IsDefaultAttribute	オーバーライドされます。 この属性が既定値かどうかを判断します。
	IsDefined	オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 ( Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 ( Attribute から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	GetLocalizedString	指定したカテゴリのローカライズされた名前を検索します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

CategoryAttribute クラス
System.ComponentModel 名前空間
Attribute
PropertyDescriptor
EventDescriptor

CategoryAttribute メンバ

PropertyGrid コントロールが [項目別] モードに設定されているときに、コントロールに表示するプロパティまたはイベントを分類するカテゴリの名前を指定します。

CategoryAttribute データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	CategoryAttribute	オーバーロードされます。 CategoryAttribute クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。(Attribute から継承されます。)
	WindowStyle	WindowStyle カテゴリを表す CategoryAttribute を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 オーバーライドされます。 指定したオブジェクトの値が現在の CategoryAttribute と等しいかどうかを示す値を返します。
	GetCustomAttribute	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用された指定した型のカスタム属性を取得します。 (Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。 アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されたカスタム属性の配列を取得します。 (Attribute から継承されます。)
	GetHashCode	オーバーライドされます。 この属性のハッシュ コードを返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsDefaultAttribute	オーバーライドされます。 この属性が既定値かどうかを判断します。
	IsDefined	オーバーロードされます。 指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッド パラメータに適用されているかどうかを判断します。 (Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (Attribute から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetLocalizedString	指定したカテゴリのローカライズされた名前を検索します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

CategoryAttribute クラス
System.ComponentModel 名前空間
Attribute
PropertyDescriptor
EventDescriptor