LocalFileSettingsProvider.SetPropertyValues 方法

定义

命名空间:

System.Configuration

程序集:

System.Configuration.ConfigurationManager.dll

包:

System.Configuration.ConfigurationManager v9.0.0-rc.2.24473.5

Source:

LocalFileSettingsProvider.cs

设置指定的属性设置组的值。

public:
 override void SetPropertyValues(System::Configuration::SettingsContext ^ context, System::Configuration::SettingsPropertyValueCollection ^ values);

public override void SetPropertyValues (System.Configuration.SettingsContext context, System.Configuration.SettingsPropertyValueCollection values);

override this.SetPropertyValues : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyValueCollection -> unit

Public Overrides Sub SetPropertyValues (context As SettingsContext, values As SettingsPropertyValueCollection)

参数

context

SettingsContext

描述当前应用程序用法的 SettingsContext。

values

SettingsPropertyValueCollection

表示要设置的属性设置组的 SettingsPropertyValueCollection。

例外

ConfigurationErrorsException

遇到了用户范围的设置，但是当前的配置仅支持应用程序范围的设置。

- 或 -

将设置保存到配置文件时发生一般性失败。

注解

派生自 ApplicationSettingsBase的设置包装类包含 Save 方法，该方法用于保留其所有设置属性的值。 此方法枚举与其设置属性关联的所有设置提供程序，并为每个提供程序调用 SetPropertyValues 方法 SettingsProvider 以执行实际的序列化操作。

SetPropertyValues 将每个用户范围的应用程序设置属性单独序列化为相应 user.config 配置文件中的相应应用程序设置。

默认情况下， SetPropertyValues 方法使用以下逻辑序列来确定序列化方案，具体取决于设置属性的类型：

1. 如果类型具有与方法实现关联的 TypeConverterConvertToString ，则使用此转换。

2. 使用 XML 序列化。

但是，可以使用 指定首选序列化机制 SettingsSerializeAsAttribute。 LocalFileSettingsProvider 在 Visual Studio 2005 中不支持二进制序列化。

如果用户范围的设置属性显式设置为其默认值，则本地文件设置提供程序将从用户配置文件中删除关联设置的条目。 此属性的下一个读取访问权限将仅使用默认值。

注意

LocalFileSettingsProvider 不使用加密来保留任何设置。 因此，请勿使用此提供程序存储纯文本密码或其他敏感信息，而无需采取其他预防措施，例如单独加密配置文件中的信息。 有关详细信息，请参阅 使用受保护的配置加密配置信息。

另请参阅

• GetPropertyValues(SettingsContext, SettingsPropertyCollection)
• Save()
• TypeConverter
• SettingsSerializeAsAttribute