System.Configuration.LocalFileSettingsProvider.SetPropertyValues 方法

上一篇：System.Configuration.LocalFileSettingsProvider.Reset 方法下一篇：System.Configuration.LocalFileSettingsProvider.Upgrade 方法

方法描述

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

语法定义(C# System.Configuration.LocalFileSettingsProvider.SetPropertyValues 方法的用法)

public override void SetPropertyValues(
	SettingsContext context,
	SettingsPropertyValueCollection values
)

参数/返回值

参数值/返回值	参数类型/返回类型	参数描述/返回描述
context	System-Configuration-SettingsContext	描述当前应用程序用法的 SettingsContext。
values	System-Configuration-SettingsPropertyValueCollection	表示要设置的属性设置组的 SettingsPropertyValueCollection。
返回值	void

提示和注释

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

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

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

如果类型具有与 ConvertToString 方法实现关联的 TypeConverter，则采用此转换。

采用 XML 序列化。

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

如果用户范围的设置属性被显式重置为其默认值，则本地文件设置提供程序将从用户配置文件中移除关联设置项。下次对此属性进行读访问时将只使用默认值。

警告

LocalFileSettingsProvider 不使用加密保存任何设置。因此，如果在使用此提供程序时没有采取其他预防措施（如单独加密配置文件中的信息），则不要存储明文密码或其他敏感信息。有关更多信息，请参见使用受保护的配置加密配置信息。