Windows 窗体控件中的特性

.NET Framework 提供了多种可应用于自定义控件和组件的成员的特性。其中的一些特性会影响类的运行时行为，另一些会影响设计时行为。

注意

本文专为 .NET Framework 而撰写。如果使用 .NET 6 或更高版本，请谨慎使用此内容。设计器系统已更改Windows 窗体，因此请务必阅读自 .NET Framework 以来的设计器更改一文。

控件和组件属性的特性

下表显示了可应用于自定义控件和组件的属性或其他成员的特性。请参阅如何：在 Windows 窗体控件中应用特性，获取一个使用了其中许多特性的示例。

Attribute	说明
AmbientValueAttribute	指定要传递给属性的值，以使该属性从另一个源中获取其值。这称为“环境”。
BrowsableAttribute	指定属性或事件是否应在“属性”窗口中显示。
CategoryAttribute	指定当属性或事件显示在一个设置为 Categorized 模式的 PropertyGrid 控件中时，用于对属性或事件分组的类别的名称。
DefaultValueAttribute	指定属性的默认值。
DescriptionAttribute	指定属性或事件的说明。
DisplayNameAttribute	为属性、事件或不采用参数的 `public void` 方法指定显示名称。
EditorAttribute	指定用于更改属性的编辑器。
EditorBrowsableAttribute	指定可在编辑器中查看的属性或方法。
HelpKeywordAttribute	为类或成员指定上下文关键字。
LocalizableAttribute	指定是否应本地化某一属性。
PasswordPropertyTextAttribute	指示对象的文本表示形式被星号等字符隐匿。
ReadOnlyAttribute	指定此特性绑定到的属性在设计时是只读还是可读/写。
RefreshPropertiesAttribute	指示关联的属性值更改时应刷新属性网格。
TypeConverterAttribute	指定对于此属性绑定到的对象要使用哪种类型作为转换器。

下表显示了可用于指定自定义控件和组件如何与数据绑定之间进行交互的特性。

Attribute	说明
BindableAttribute	指定属性是否通常用于绑定。
ComplexBindingPropertiesAttribute	指定组件的数据源和数据成员属性。
DefaultBindingPropertyAttribute	指定组件的默认绑定属性。
LookupBindingPropertiesAttribute	指定组件的数据源和数据成员属性。
AttributeProviderAttribute	启用特性重定向。

下表显示了可用于在设计时指定自定义控件和组件的行为的特性。

属性	说明
DefaultEventAttribute	指定组件的默认事件。
DefaultPropertyAttribute	指定组件的默认属性。
DesignerAttribute	指定用于为组件实现设计时服务的类。
DesignerCategoryAttribute	指定类设计器属于某一类别。
ToolboxItemAttribute	表示工具箱项的特性。
ToolboxItemFilterAttribute	指定要用于工具箱项的筛选器字符串和筛选器类型。