System.Configuration.LocalFileSettingsProvider 类

上一篇：system.configuration.keyvalueconfigurationelement.Init 方法下一篇：System.Configuration.LocalFileSettingsProvider.GetPreviousVersion 方法

方法描述

为应用程序设置类提供持久性存储。

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

[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
[PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust")]
public class LocalFileSettingsProvider : SettingsProvider, 
	IApplicationSettingsProvider

构造函数

构造函数名称	构造函数描述
LocalFileSettingsProvider	初始化 LocalFileSettingsProvider 类的新实例。

成员/方法

方法名称	方法描述
Equals(Object)	确定指定的 Object 是否等于当前的 Object。（继承自 Object。）
Finalize	允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。（继承自 Object。）
GetHashCode	用作特定类型的哈希函数。（继承自 Object。）
GetPreviousVersion	返回同一应用程序的早期版本的命名设置属性的值。
GetPropertyValues	为指定的应用程序实例和设置属性组返回设置属性值的集合。（重写 SettingsProvider.GetPropertyValues(SettingsContext, SettingsPropertyCollection)。）
GetType	获取当前实例的 Type。（继承自 Object。）
Initialize	初始化提供程序。（重写 ProviderBase.Initialize(String, NameValueCollection)。）
MemberwiseClone	创建当前 Object 的浅表副本。（继承自 Object。）
Reset	将与指定的应用程序关联的所有应用程序设置属性重置为其默认值。
SetPropertyValues	设置指定的属性设置组的值。（重写 SettingsProvider.SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)。）
ToString	返回表示当前对象的字符串。（继承自 Object。）
Upgrade	尝试从相同应用程序的早期版本迁移以前的用户范围设置。

提示和注释

设置提供程序定义了一种用来存储应用程序设置结构中使用的配置数据的机制。 .NET Framework 包含一个默认设置提供程序 LocalFileSettingsProvider，该提供程序将配置数据存储到本地文件系统。应用程序设置属性或属性组通过使用 SettingsProviderAttribute 与特定的设置提供程序相关联。

通常，客户端程序并不显式访问此类；而是在需要其服务时由应用程序设置结构自动调用相应的设置提供程序。例如，ApplicationSettingsBase 的许多成员将其工作委托给关联的设置提供程序。

LocalFileSettingsProvider 将设置保存到扩展名为 .config 的配置文件。配置文件的内容以 XML 文档的格式构建。根据设置的范围是应用程序级别还是用户级别，分别将配置数据存储为中的元素或节组。这些节组中的每一个都分别由对应的 AppSettingsSection 或 ClientSettingsSection 表示。每个节对象均由配置节处理程序拥有和管理，配置节处理程序是 IConfigurationSectionHandler 类型的对象。

应用程序范围的设置和默认用户范围的设置存储在名为 application.exe.config 的文件中，该文件在与可执行文件相同的目录中创建。应用程序配置设置为只读。特定的用户数据存储在用户主目录下名为 user.config 的文件中。如果启用了漫游配置文件，则可存在两个版本的用户配置文件。在这种情况下，漫游版本中的项优先于本地用户配置文件中的重复项。

有关应用程序设置的更多信息，请参见Windows 窗体的应用程序设置。