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 | 指定要用于工具箱项的筛选器字符串和筛选器类型。 |