应用程序设置属性

更新:2007 年 11 月

应用程序设置结构提供很多属性 (Attribute),这些属性 (Attribute) 可应用于应用程序设置包装类或应用程序设置包装类的各个属性 (Property)。这些属性 (Attribute) 在运行时由应用程序设置基础结构(通常具体指设置提供程序)进行检查,以便使这些属性 (Attribute) 的功能符合自定义包装的要求。

下表中列出了一些属性 (Attribute),这些属性 (Attribute) 有的可应用于应用程序设置包装类、有的可应用于应用程序设置包装类的各个属性 (Property),有的可应用于这两者。根据定义,对于每个设置属性 (Property),必须而且只能应用一个范围属性 (Attribute)(UserScopedSettingAttributeApplicationScopedSettingAttribute)。

ms171564.alert_note(zh-cn,VS.90).gif说明:

只有在识别以下三个属性 (Attribute):ApplicationScopedSettingAttributeUserScopedSettingAttributeDefaultSettingValueAttribute 时,才需要从 SettingsProvider 类派生的自定义设置提供程序。

属性 (Attribute)

目标

说明

SettingsProviderAttribute

属性 (Property) 和类

指定要用于保持的设置提供程序的简称。

如果未提供此属性 (Attribute),则假定为默认提供程序 LocalFileSettingsProvider

UserScopedSettingAttribute

属性 (Property) 和类

将属性 (Property) 定义为用户范围的应用程序设置。

ApplicationScopedSettingAttribute

属性 (Property) 和类

将属性 (Property) 定义为应用程序范围的应用程序设置。

DefaultSettingValueAttribute

属性 (Property)

指定一个字符串,提供程序可以将该字符串反序列化为此属性 (Property) 的硬编码默认值。

LocalFileSettingsProvider 不需要此属性 (Attribute),如果已保留某个值,则设置提供程序将重写此属性 (Attribute) 所提供的任何相应值。

SettingsDescriptionAttribute

属性 (Property)

对单个设置进行描述性检查,该属性 (Attribute) 主要由运行时和设计时工具使用。

SettingsGroupNameAttribute

提供设置组的显式名称。如果没有此属性 (Attribute),则 ApplicationSettingsBase 使用包装类的名称。

SettingsGroupDescriptionAttribute

对设置组进行描述性检查,该属性 (Attribute) 主要由运行时和设计时工具使用。

SettingsManageabilityAttribute

属性 (Property) 和类

指定零个或多个应提供给设置组或属性 (Property) 的管理功能服务。可用的服务在 SettingsManageability 枚举中给出。

SpecialSettingAttribute

属性 (Property)

指示设置属于专用的预定义类别(如连接字符串),该类别应由设置提供程序进行专门处理。此属性 (Attribute) 的预定义类别由 SpecialSetting 枚举定义。

SettingsSerializeAsAttribute

属性 (Property) 和类

指定设置组或属性 (Property) 的首选序列化机制。可用序列化机制由 SettingsSerializeAs 枚举定义。

NoSettingsVersionUpgradeAttribute

属性 (Property)

指定设置提供程序应禁用已标记属性 (Property) 的所有应用程序升级功能。

“类”指示属性 (Attribute) 只可以应用到应用程序设置包装类。“属性 (Property)”指示属性 (Attribute) 只可以应用到设置属性 (Property)。“属性 (Property) 和类”指示 (Attribute) 可应用到任何一级。

请参见

任务

如何:使用设计器创建应用程序设置

概念

应用程序设置结构

参考

ApplicationSettingsBase

SettingsProvider