应用程序设置特性

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

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

提示

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

特性

Target

说明

SettingsProviderAttribute

两者

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

如果未提供此特性,则假定为默认提供程序 LocalFileSettingsProvider

UserScopedSettingAttribute

属性和类

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

ApplicationScopedSettingAttribute

属性和类

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

DefaultSettingValueAttribute

Property

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

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

SettingsDescriptionAttribute

Property

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

SettingsGroupNameAttribute

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

SettingsGroupDescriptionAttribute

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

SettingsManageabilityAttribute

属性和类

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

SpecialSettingAttribute

Property

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

SettingsSerializeAsAttribute

属性和类

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

NoSettingsVersionUpgradeAttribute

Property

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

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

请参见

任务

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

参考

ApplicationSettingsBase

SettingsProvider

概念

应用程序设置体系结构