Windows フォーム コントロールの属性Attributes in Windows Forms Controls

.NET Framework には、カスタム コントロールおよびカスタム コンポーネントのメンバーに適用できるさまざまな属性が用意されています。The .NET Framework provides a variety of attributes you can apply to the members of your custom controls and components. これらの属性には、クラスの実行時の動作に影響を及ぼすものもあれば、デザイン時の動作に影響を及ぼすものもあります。Some of these attributes affect the run-time behavior of a class, and others affect the design-time behavior.

コントロールおよびコンポーネントのプロパティの属性Attributes for Control and Component Properties

次の表には、カスタム コントロールおよびカスタム コンポーネントのプロパティや他のメンバーに適用できる属性が示されています。The following table shows the attributes you can apply to properties or other members of your custom controls and components. これらの属性の多くを使用する例を参照してください方法。Windows フォーム コントロールに属性を適用します。For an example that uses many of these attributes, see How to: Apply Attributes in Windows Forms Controls.

属性Attribute 説明Description
AmbientValueAttribute プロパティに渡す値を指定し、そのプロパティが別のソースから値を取得するようにします。Specifies the value to pass to a property to cause the property to get its value from another source. これは "アンビエンス" と呼ばれています。This is known as ambience.
BrowsableAttribute プロパティまたはイベントが [プロパティ] ウィンドウに表示されるかどうかを指定します。Specifies whether a property or event should be displayed in a Properties window.
CategoryAttribute プロパティまたはイベントに表示するときにグループ化するためのカテゴリの名前を指定します、PropertyGridコントロールに対して設定Categorizedモード。Specifies the name of the category in which to group the property or event when displayed in a PropertyGrid control set to Categorized mode.
DefaultValueAttribute プロパティの既定値を指定します。Specifies the default value for a property.
DescriptionAttribute プロパティまたはイベントの説明文を指定します。Specifies a description for a property or event.
DisplayNameAttribute 引数を受け取らないプロパティ、イベント、または public void メソッドの表示名を指定します。Specifies the display name for a property, event, or public void method that takes no arguments.
EditorAttribute プロパティの変更に使用するエディターを指定します。Specifies the editor to use to change a property.
EditorBrowsableAttribute プロパティまたはメソッドをエディターで表示できるかどうかを指定します。Specifies that a property or method is viewable in an editor.
HelpKeywordAttribute クラスまたはメンバーのコンテキスト キーワードを指定します。Specifies the context keyword for a class or member.
LocalizableAttribute プロパティをローカライズする必要があるかどうかを指定します。Specifies whether a property should be localized.
PasswordPropertyTextAttribute アスタリスクなどの文字で、オブジェクトのテキスト表記を隠すように指示します。Indicates that an object's text representation is obscured by characters such as asterisks.
ReadOnlyAttribute デザイン時に、この属性がバインドされるプロパティが読み取り専用か読み取り/書き込み可能かを指定します。Specifies whether the property this attribute is bound to is read-only or read/write at design time.
RefreshPropertiesAttribute 関連付けられているプロパティ値が変更されたときに、プロパティ グリッドが更新されるように指定します。Indicates that the property grid should refresh when the associated property value changes.
TypeConverterAttribute この属性が関連付けられているオブジェクトのコンバーターとして使用する型を指定します。Specifies what type to use as a converter for the object this attribute is bound to.

データ バインディング プロパティの属性Attributes for Data Binding Properties

次の表には、カスタム コントロールおよびカスタム コンポーネントがデータ バインディングと相互作用する方法を指定するために適用できる属性が示されています。The following table shows the attributes you can apply to specify how your custom controls and components interact with data binding.

属性Attribute 説明Description
BindableAttribute バインディングにプロパティが通常、使用されるかどうかを指定します。Specifies whether a property is typically used for binding.
ComplexBindingPropertiesAttribute コンポーネントのデータ ソースおよびデータ メンバーのプロパティを指定します。Specifies the data source and data member properties for a component.
DefaultBindingPropertyAttribute コンポーネントの既定のバインディング プロパティを指定します。Specifies the default binding property for a component.
LookupBindingPropertiesAttribute コンポーネントのデータ ソースおよびデータ メンバーのプロパティを指定します。Specifies the data source and data member properties for a component.
AttributeProviderAttribute 属性のリダイレクトを有効にします。Enables attribute redirection.

クラスの属性Attributes for Classes

次の表には、デザイン時にカスタム コントロールおよびカスタム コンポーネントの動作を指定するために適用できる属性が示されています。The following table shows the attributes you can apply to specify the behavior of your custom controls and components at design time.

属性Attribute 説明Description
DefaultEventAttribute コンポーネントの既定のイベントを指定します。Specifies the default event for a component.
DefaultPropertyAttribute コンポーネントの既定のプロパティを指定します。Specifies the default property for a component.
DesignerAttribute コンポーネントのデザイン時サービスを実装するために使用されるクラスを指定します。Specifies the class used to implement design-time services for a component.
DesignerCategoryAttribute クラスのデザイナーが特定のカテゴリに属することを指定します。Specifies that the designer for a class belongs to a certain category.
ToolboxItemAttribute ツールボックス項目の属性を表します。Represents an attribute of a toolbox item.
ToolboxItemFilterAttribute ツールボックス項目に使用するフィルター文字列とフィルターの種類を指定します。Specifies the filter string and filter type to use for a Toolbox item.

関連項目See also