• 【.net 深呼吸】在运行阶段修改应用配置文件


    上一篇博文中,老周所介绍的自行编写的配置类,虽然能够很好地做封装,但它仅允许修改用户级别的配置,所以文件都是保存到用户配置目录下的。可是,许多情况下,我们还是不考虑用户隔离,而是能够直接修改与应用程序同目录的App.config文件。

    那么,能不能在代码文件中编辑 app.config 文件呢?当然是可以的。其实,配置文件本质上是个XML文档,所以,你是可以使用普通XML文件的编辑方式来修改的。但.net类库还是提供有于读写配置文件的专用API,使用专用的API,使得生成的配置比较规范。

    .net 的配置文件是由N个配置节组成,每个配置节面向不同的功能,比如 startup 可以配置程序所需要的.net 框架版本。为了便于管理,通常,咱们的应用程序设置都会放到 AppSettings 节上,XML节点为 appSettings。每一条配置都比较简单,就是由 key 和 value 组成。

    要对配置文件进行操作,你记得要引用 System.Configuration.dll 程序集,因为System程序集只包含一些常规的类型,而专用于读写配置文件的类型都会包装到 System.Configuration 程序集中。这些API既适用于app.config,也适用于web.config文件。

    好,上面这几段废话只要你看懂了,那么下面我们就可以开始干活了。放心,很简单的,老周给你分享的东西,向来都是简单且有实用价值的。

    首先,老周介绍一下大概的类型使用过程。

    ——读取 app.config 文件中 appSettings 节中的内容很简单,使用 ConfigurationManager 类,它公开了两个静态属性,别小看它们,有了这两个属性,读取配置会轻松很多。ConnectionStrings:做过数据库连接的话,你肯定很熟悉它的,这个节点下专门存放连接字符串;AppSettings:这个专门访问 appSettings 节点下的内容,表示形式很简洁,就是key - value 对,而且都是字符串类型。

    ——写入修改会稍稍复杂一点,但也不是难题。

      a、ConfigurationManager类有个静态方法 OpenExeConfiguration ,你可以指定exe文件路径,它自动找到匹配的app.config文件,然后打开,返回一个 Configuration 类型的实例。

      b、Configuration 类可以对配置文件进行修改,修改完后,可以掉用 Save 方法保存,或调用 SaveAs 方法把配置存到其他文件上。

    接下来,老周上一个例子,这个例子运行后,在窗口上可以设置电脑自爆的日期,当窗口关闭时会把这个日期写入配置文件中的appSettings 节点下。如下图所示。

     跟你开个玩笑而已,计算机不会真的爆炸。

    通常,我们会在窗口加载时读出配置文件中的值,以便在界面上显示用户上一次设置的内容,不然用户会误以为配置丢失。

                var q = ConfigurationManager.AppSettings.AllKeys.AsQueryable();
                var r = from c in q where c == BOMB_DATE select c;
                if (r.Count() > 0)
                {
                    string datestr = ConfigurationManager.AppSettings[BOMB_DATE];
                    picker.SelectedDate = DateTime.Parse(datestr);
                }

    在读应用配置前,我用 LINQ 语句查询了一下,确认我要访问的设置项是否存在,如果没有要的设置项,那读个鸡毛。设置节的key是用字符串来表示的,BOMB_DATE是我定义的一个常量。

     const string BOMB_DATE = "bombDate";

    配置文件中的设置值是以字符串形保存的,而咱们窗口上的控件需要的是 DateTime 类型的实例,所以读出来后记得要 Parse 一下。

    接下来,我们再看看如何修改并保存 app.config 文件。

    先把日期选择控件中用户选择的日期转为字符串。

                DateTime seldate = picker.SelectedDate ?? DateTime.Today;
                string forstr = seldate.ToShortDateString();

    然后,还得获取当前程序的exe路径。

    string exePath = Environment.GetCommandLineArgs()[0];

    GetCommandLineArgs 方法返回的字符串数组中,第一个元素就是本程序exe的路径。

    调用 ConfigurationManager.OpenExeConfiguration 静态方法打开app.config文件。

                Configuration config = ConfigurationManager.OpenExeConfiguration(exePath);

    随后,是重点部分,就是写入设置内容。

                if (config.AppSettings.Settings.AllKeys.Count(s => s == BOMB_DATE) > 0)
                {
                    // 如果设置项已经存在
                    // 则直接修改
                    var kv = config.AppSettings.Settings[BOMB_DATE];
                    kv.Value = forstr;
                }
                else
                {
                    // 如果设置项不存在
                    // 则添加新项
                    config.AppSettings.Settings.Add(BOMB_DATE, forstr);
                }

    这里有个很严重的内容,大家一定、必须、特别要注意。得判一下设置项的key是否已存在,因为你如果直接调用 Add 方法添加的话,如果设置项的key已存在,它不是替换整个值,而是会在原来的值后面追加内容。

    比如在本例中,要是我写入了 2017/10/1,第一次保存,因为设置项不存在,所以没问题。但是,一旦我把值修改为 2017/11/5,然后再保存,那么设置项的值 就会变为

    2017/10/1,2017/11/5

    也就是说,新保存的内容不会替换,而是追加,然后用逗号分隔每个值。

    如此一来,在读取的时候就麻烦了,这样的字符串是不能转化为 DateTime 实例的。

    所以,这里要先分析一下,如果设置项已经存在,那就通过索引器得到这个设置项的内容,它用一个 KeyValueConfigurationElement 类封装,其中,Value 属性是可以修改的(Key不能变,所以只读),此时,我们只要直接给 Value 属性赋新的值,那么保存时就会覆盖原有的值,而不会在后面追加了。而如果设置项不存在,那太好办,直接一个Add方法添加就可以了。

    最后,修改完了,别忘了保存,不保存的话,是不会写入app.config文件的。

                if (config.AppSettings.SectionInformation.IsLocked)
                {
                    // 如果配置节已锁定,则放弃保存
                    return;
                }
                config.Save(ConfigurationSaveMode.Modified);

    保存前检测 IsLocked 属性,是看看这个配置节是否被锁定,如果锁了,你是不能保存的。

    在配置文件中,你可以用这种方法来让某个节点被锁定。

        <appSettings lockItem="true">
            ……

    </appSettings>

    锁定后,节点就不允许别人编辑了。当然了,你手动打开配置文件是可以改的,我说的是在代码中用API不能改。

    在调用 Configuration 实例的 Save 方法时,可以向方法传递一个 ConfigurationSaveMode 枚举值,这里我用 Modified,表示只对被修改过的节点进行写入,这样做可以省时省力省开销。

    保存后的 app.config 文件的appSettings节点如下。

        <appSettings>
            <add key="bombDate" value="2017/7/28" />
        </appSettings>

    =================================================

    以上示例的源代码下载,请点击▶这里◀

    怎么样,学了后有用吧。差点忘了说,如果你把exe文件放在如 Program Files 等需要管理员权限的目录中,你必须以管理员身份运行应用程序才能保存配置文件。

  • 相关阅读:
    Maven核心简析
    块/文件/对象存储对比性概述
    Java SE-基本数据类型对应包装类
    Maven+eclipse快速入门
    IaaS、PaaS、SaaS、CaaS、MaaS五者的区别
    Collections.shuffle()源码分析
    java集合继承关系图
    ArrayList和LinkedList的区别
    ArrayList的实现原理
    session以及分布式服务器session共享
  • 原文地址:https://www.cnblogs.com/tcjiaan/p/7238415.html
Copyright © 2020-2023  润新知