LocalFileSettingsProvider 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
为应用程序设置类提供持久性。
public ref class LocalFileSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProviderpublic class LocalFileSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvidertype LocalFileSettingsProvider = class
inherit SettingsProvider
interface IApplicationSettingsProviderPublic Class LocalFileSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider- 继承
- 实现
注解
设置提供程序定义用于存储应用程序设置体系结构中使用的配置数据的机制。 .NET框架包含单个默认设置提供程序，LocalFileSettingsProvider，用于将配置数据存储到本地文件系统。 应用程序设置属性或属性组通过使用 <
通常，客户端程序不显式访问此类;相反，应用程序设置体系结构会在需要其服务时自动调用相应的设置提供程序。 例如，将工作委托给关联的设置提供程序的许多成员 ApplicationSettingsBase 。
LocalFileSettingsProvider 将设置保存到扩展名为的 .config配置文件。 配置文件的内容结构为 XML 文档。 根据设置是在应用程序级别还是用户级别范围内，配置数据分别作为元素存储在某个 <applicationSettings> 或 <userSettings> 分区组中。 每个部分组分别由相应的 AppSettingsSection 或 ClientSettingsSection分别表示。 每个节对象由配置节处理程序拥有和管理，该处理程序是一个类型 IConfigurationSectionHandler的对象。
应用程序范围的设置和默认的用户范围设置存储在名为 application.exe.config的文件中，该文件在可执行文件所在的同一目录中创建。 应用程序配置设置是只读的。 特定用户数据存储在名为 user.config的文件中，存储在用户的主目录下。 如果启用了漫游配置文件，则可能存在两个版本的用户配置文件。 在这种情况下，漫游版本中的条目优先于本地用户配置文件中的重复条目。
有关应用程序设置的详细信息，请参阅 application Settings for 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) |
尝试从同一应用程序的以前版本迁移以前的用户范围设置。 |
