本篇博客将介绍C#中Settings的使用。
首先介绍一个桌面程序中的例子,当我们新安装一个软件,软件启动后会有例如新手指导等窗体弹出来,每次都需要自己去关闭它。当然这些软件都会提供例如不再显示等功能。当选择不再显示功能后,这些窗体以后再也不显示了。
对于这些设置,可以采用下面的一些方法来存储,自定义XML文件,注册表,当然还可以是C#中自带的Settings文件。推荐使用Settings文件。注册表轻易不要使用,自定义XML在使用时需要解析,可以当备选方案。
下面通过一个例子来展示,
新建一个WPF项目,
蓝色背景的便是Settings,
一个Setting有4个属性Name,Type,Scope,Value。重点讲一下Scope属性,Scope属性有两个值Application,User。这两者区别,Scope值为Application时,对应的Setting在运行时不可以修改。Scope值为User时,对应的Setting在运行时可以修改。
Setting保存位置:当程序编译后,Setting的值保存在<AssemblyName>.exe.config文件中,例如:
在程序中使用Setting,
// Modify the setting value Properties.Settings.Default.DisplayGuide = false; // Save setting value Properties.Settings.Default.Save();
其中,Settings里的属性根据范围分为两种 “用户”和“应用程序”(其中:应用程序级配置是只读的,而用户级是可读写的。)
范围为“应用程序”的属性,读取都是从APP.CONFIG里获取,设置也可以通过手工修改App.config改变,但是在程序中无法对其进行赋值,只能读取。
而范围为“用户”的属性 Settings 在第一次运行时会读取App.config里的初始值
但是一旦调用Save方法后,Settings里“用户”范围的属性就会保存在系统里面,类似WebForm里的Cookies一样
从此以后,读取都会从系统里保存的值里读取,手工修改App.config里的“用户”范围的属性不会影响到这些属性,但是在调用Reset方法时会从新从App.config里获取“用户”范围的属性写入到系统中。
也就是说,settings里“用户”范围的属性总共有3个地方存储。
1、app.config配置文件-----程序第一次运行,之前程序未调用save(),在系统中找不到就会从这里获取
2、操作系统--------当settings调用save()保存后。
3、内存----程序启动后,实例化settings对象,该实例在创建的时候从系统(如果系统中没有就如前面提到的从配置文件中获取)读取在内存中。
一旦我们通过VC#给它添加值后,在工程目录下会生成一个 app.config 文件。
那么,这两个东西究竟是什么关系?
添加两个字符串类型的配置值(一个应用程序级,一个是用户级)后:
- Settings.settings
<?xml version=‘1.0‘ encoding=‘utf-8‘?>
<SettingsFile xmlns="http://schemas.microsoft.com/VisualStudio/2004/01/settings" CurrentProfile="(Default)" GeneratedClassNamespace="WpfApplication1.Properties" GeneratedClassName="Settings">
<Profiles />
<Settings>
<Setting Name="thisIsAppSettings" Type="System.String" Scope="Application">
<Value Profile="(Default)">dbzhang800</Value>
</Setting>
<Setting Name="thisIsUserSettings" Type="System.String" Scope="User">
<Value Profile="(Default)">1+1=2</Value>
</Setting>
</Settings>
</SettingsFile>
- app.config
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<sectionGroup name="userSettings" type="System.Configuration.UserSettingsGroup, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
<section name="WpfApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" requirePermission="false" />
</sectionGroup>
<sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
<section name="WpfApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />
</sectionGroup>
</configSections>
<userSettings>
<WpfApplication1.Properties.Settings>
<setting name="thisIsUserSettings" serializeAs="String">
<value>1+1=2</value>
</setting>
</WpfApplication1.Properties.Settings>
</userSettings>
<applicationSettings>
<WpfApplication1.Properties.Settings>
<setting name="thisIsAppSettings" serializeAs="String">
<value>dbzhang800</value>
</setting>
</WpfApplication1.Properties.Settings>
</applicationSettings>
</configuration>
尽管都是 xml 文件,两个文件的风格截然不同,后者 app.config 就是我们前一篇中介绍到了 Configuration 文件,从它的configSections中可以看出它有两个自定义段,分别叫applicationSettings 和 userSettings
操作这样的一个文件,我们可以创建ConfigurationManager命名空间中的ConfigurationSection的派生类,然后通过该类进行操作。
Settings.settings 看起来相当的简洁,而且和app.config相比,它包含有配置值的类型(比如:Type="System.String")。
而且,无论我们修改Settings.settings还是app.config,Visual studio都会提示我们,并自动同步到另一个文件中。
- Settings.settings 文件的存在的目的是为了生成一个名为 Settings.Designer.cs 的文件,该文件内的类提供了操作配置文件 (比如:program.exe.config) 的封装类。
- app.config 会被拷贝到应用程序目录下,并变身为 program.exe.config
这样一来,在程序内就可以通过
Properties.Settings.Default.thisIsUserSettings = "999999999";
console.WriteLine(Properties.Settings.Default.thisIsAppSettings);
Properties.Settings.Default.Save();
来操作配置文件了。
用户配置会被写入到
C:\Users\Administrator\AppData\Roaming\微软中国\IntelligentGet.dll_Url_4e1wbw1oe2fpsm1rmlrbj4nuwvigphrb\1.0.0.0\user.config
这些文件中。
多个.settings文件
同一个工程中,可以添加多个 .settings 文件,每一个都会生成一个封装类,各对 app.config 中的一部分进行操作。