LocalFileSettingsProvider 类

定义

命名空间:

System.Configuration

程序集:

System.Configuration.ConfigurationManager.dll

包:

System.Configuration.ConfigurationManager v8.0.0

Source:

LocalFileSettingsProvider.cs

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

public ref class LocalFileSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProvider

public class LocalFileSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvider

type LocalFileSettingsProvider = class
    inherit SettingsProvider
    interface IApplicationSettingsProvider

Public Class LocalFileSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider

继承

Object

ProviderBase

SettingsProvider

LocalFileSettingsProvider

实现

IApplicationSettingsProvider

注解

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

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

LocalFileSettingsProvider 将设置保存到扩展名 .config为 的配置文件中。 配置文件的内容结构为 XML 文档。 根据设置的范围是应用程序级别还是用户级别，配置数据将分别作为 元素 <applicationSettings> 存储在 或 <userSettings> 节组中。 其中每个节组分别由相应的 AppSettingsSection 或 ClientSettingsSection表示。 每个节对象都由配置节处理程序拥有和管理，该处理程序是 类型的 IConfigurationSectionHandler对象。

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

有关应用程序设置的详细信息，请参阅Windows 窗体的应用程序设置。

构造函数

LocalFileSettingsProvider()

初始化 LocalFileSettingsProvider 类的新实例。

属性

ApplicationName	获取或设置当前运行的应用程序的名称。
Description	获取一条简短的易懂描述，它适合在管理工具或其他用户界面 (UI) 中显示。 (继承自 ProviderBase)
Name	获得一个友好名称，用于在配置过程中引用提供程序。 (继承自 ProviderBase)

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetPreviousVersion(SettingsContext, SettingsProperty)	返回同一应用程序的早期版本的命名设置属性的值。
GetPropertyValues(SettingsContext, SettingsPropertyCollection)	为指定的应用程序实例和设置属性组返回设置属性值的集合。
GetType()	获取当前实例的 Type。 (继承自 Object)
Initialize(String, NameValueCollection)	初始化提供程序。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
Reset(SettingsContext)	将与指定的应用程序关联的所有应用程序设置属性重置为其默认值。
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)	设置指定的属性设置组的值。
ToString()	返回表示当前对象的字符串。 (继承自 Object)
Upgrade(SettingsContext, SettingsPropertyCollection)	尝试从相同应用程序的早期版本迁移以前的用户范围设置。

另请参阅

• SettingsProviderAttribute
• ApplicationScopedSettingAttribute
• UserScopedSettingAttribute
• ApplicationSettingsBase
• ClientSettingsSection
• IConfigurationSectionHandler
• 应用程序设置体系结构