应用程序设置属性
更新:2007 年 11 月
应用程序设置结构提供很多属性 (Attribute),这些属性 (Attribute) 可应用于应用程序设置包装类或应用程序设置包装类的各个属性 (Property)。这些属性 (Attribute) 在运行时由应用程序设置基础结构(通常具体指设置提供程序)进行检查,以便使这些属性 (Attribute) 的功能符合自定义包装的要求。
下表中列出了一些属性 (Attribute),这些属性 (Attribute) 有的可应用于应用程序设置包装类、有的可应用于应用程序设置包装类的各个属性 (Property),有的可应用于这两者。根据定义,对于每个设置属性 (Property),必须而且只能应用一个范围属性 (Attribute)(UserScopedSettingAttribute 或 ApplicationScopedSettingAttribute)。
说明: |
---|
只有在识别以下三个属性 (Attribute):ApplicationScopedSettingAttribute、UserScopedSettingAttribute 和 DefaultSettingValueAttribute 时,才需要从 SettingsProvider 类派生的自定义设置提供程序。 |
属性 (Attribute) |
目标 |
说明 |
---|---|---|
属性 (Property) 和类 |
指定要用于保持的设置提供程序的简称。 如果未提供此属性 (Attribute),则假定为默认提供程序 LocalFileSettingsProvider。 |
|
属性 (Property) 和类 |
将属性 (Property) 定义为用户范围的应用程序设置。 |
|
属性 (Property) 和类 |
将属性 (Property) 定义为应用程序范围的应用程序设置。 |
|
属性 (Property) |
指定一个字符串,提供程序可以将该字符串反序列化为此属性 (Property) 的硬编码默认值。 LocalFileSettingsProvider 不需要此属性 (Attribute),如果已保留某个值,则设置提供程序将重写此属性 (Attribute) 所提供的任何相应值。 |
|
属性 (Property) |
对单个设置进行描述性检查,该属性 (Attribute) 主要由运行时和设计时工具使用。 |
|
类 |
提供设置组的显式名称。如果没有此属性 (Attribute),则 ApplicationSettingsBase 使用包装类的名称。 |
|
类 |
对设置组进行描述性检查,该属性 (Attribute) 主要由运行时和设计时工具使用。 |
|
属性 (Property) 和类 |
指定零个或多个应提供给设置组或属性 (Property) 的管理功能服务。可用的服务在 SettingsManageability 枚举中给出。 |
|
属性 (Property) |
指示设置属于专用的预定义类别(如连接字符串),该类别应由设置提供程序进行专门处理。此属性 (Attribute) 的预定义类别由 SpecialSetting 枚举定义。 |
|
属性 (Property) 和类 |
指定设置组或属性 (Property) 的首选序列化机制。可用序列化机制由 SettingsSerializeAs 枚举定义。 |
|
属性 (Property) |
指定设置提供程序应禁用已标记属性 (Property) 的所有应用程序升级功能。 |
“类”指示属性 (Attribute) 只可以应用到应用程序设置包装类。“属性 (Property)”指示属性 (Attribute) 只可以应用到设置属性 (Property)。“属性 (Property) 和类”指示 (Attribute) 可应用到任何一级。