System.Configuration.LocalFileSettingsProvider 类

方法描述

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

语法定义(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 窗体的应用程序设置。

System.Configuration.LocalFileSettingsProvider 类例子


继承层次结构

System.Object

System.Configuration.Provider.ProviderBase

System.Configuration.SettingsProvider

System.Configuration.LocalFileSettingsProvider

命名空间

namespace: System.Configuration

程序集: System(在 System.dll 中)

线程安全

此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。