.NET配置文件讀寫實例（附SosoftConfigHelper類）

配置文件在軟件開發中起到舉足輕重的作用，可以說不可或缺。.NET程序可使用.config文件作為配置文件，例如WinForm程序的*.app.config、Web程序的web.config。.config文件是標准的XML文件。本實例可讀取、修改和添加app.confing或者web.config文件的appSettings。SosoftConfigHelper類還可以讀寫ConnectionStrings。

使用Visual Studio創建一個WinForm項目，在窗體上建立控件，如圖：

鍵值列表中的值是運行結果。

然后在更新配置按鈕事件方法中加入如下代碼：

SosoftConfigHelper.UpdateAppConfig(textBox_key.Text, textBox_value.Text);

窗體的代碼如下：

/*
Copyright (c) 2012  柔城  All rights reserved.
 * 
 * sosoft.cnblogs.com
 */
using System;
using System.Configuration;
using System.Windows.Forms;
using Sosoft.Cnblogs.Com.Helper;

namespace Sosoft.Cnblogs.Com
{
    public partial class MainForm : Form
    {
        public MainForm()
        {
            InitializeComponent();
        }

        private void button_update_Click(object sender, EventArgs e)
        {
            SosoftConfigHelper.UpdateAppConfig(textBox_key.Text, textBox_value.Text);
            GetKeyValueList();
        }

        private void GetKeyValueList()
        {
            textBox_keyValueList.Text = string.Empty;
            foreach (string key in ConfigurationManager.AppSettings)
            {
                textBox_keyValueList.Text += key + " : " + SosoftConfigHelper.GetAppConfig(key) + "\r\n";
            }
        }

        private void MainForm_Load(object sender, EventArgs e)
        {
            GetKeyValueList();
        }
    }
}

記得要添加System.Configuration命名空間和程序集的引用。

另外新建一個類，命名SosoftConfigHelper.cs，這是配置文件讀寫類，代碼如下：

/*
Copyright (c) 2012  柔城  All rights reserved.
 * 
 * sosoft.cnblogs.com
 */
using System;
using System.Configuration;

namespace Sosoft.Cnblogs.Com.Helper
{
    /// <summary>
    /// Sosoft配置文件輔助類
    /// </summary>
    public class SosoftConfigHelper
    {
        /// <summary>
        ///  讀取appStrings配置節， 返回＊.exe.config文件中appSettings配置節的value項
        /// </summary>
        /// <param name="strKey"></param>
        /// <returns></returns>
        public static string GetAppConfig(string strKey)
        {
            foreach (string key in ConfigurationManager.AppSettings)
            {
                if (key == strKey)
                {
                    return ConfigurationManager.AppSettings[strKey];
                }
            }
            return null;
        }


        /// <summary>
        /// 更新appStrings配置節,在＊.exe.config文件中appSettings配置節增加一對鍵、值對
        /// </summary>
        /// <param name="newKey"></param>
        /// <param name="newValue"></param>
        public static void UpdateAppConfig(string newKey, string newValue)
        {
            bool isModified = false;
            foreach (string key in ConfigurationManager.AppSettings)
            {
                if (key == newKey)
                {
                    isModified = true;
                }
            }

            // Open App.Config of executable
            Configuration config =
                ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None);
            // You need to remove the old settings object before you can replace it
            if (isModified)
            {
                config.AppSettings.Settings.Remove(newKey);
            }
            // Add an Application Setting.
            config.AppSettings.Settings.Add(newKey, newValue);
            // Save the changes in App.config file.
            config.Save(ConfigurationSaveMode.Modified);
            // Force a reload of a changed section.
            ConfigurationManager.RefreshSection("appSettings");
        }



        /// <summary>
        /// 讀取connectionStrings配置節,依據連接串名字connectionName返回數據連接字符串
        /// </summary>
        /// <param name="connectionName"></param>
        /// <returns></returns>
        public static string GetConnectionStringsConfig(string connectionName)
        {
            string connectionString =
                    ConfigurationManager.ConnectionStrings[connectionName].ConnectionString.ToString();
            Console.WriteLine(connectionString);
            return connectionString;
        }


        /// <summary>
        /// 更新connectionStrings配置節, 更新連接字符串
        /// </summary>
        /// <param name="newName"> 連接字符串名稱 </param>
        /// <param name="newConString"> 連接字符串內容 </param>
        /// <param name="newProviderName"> 數據提供程序名稱 </param>
        public static void UpdateConnectionStringsConfig(string newName,
            string newConString,
            string newProviderName)
        {
            bool isModified = false;    // 記錄該連接串是否已經存在
            // 如果要更改的連接串已經存在
            if (ConfigurationManager.ConnectionStrings[newName] != null)
            {
                isModified = true;
            }
            // 新建一個連接字符串實例
            ConnectionStringSettings mySettings =
                new ConnectionStringSettings(newName, newConString, newProviderName);
            // 打開可執行的配置文件*.exe.config
            Configuration config =
                ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None);
            // 如果連接串已存在，首先刪除它
            if (isModified)
            {
                config.ConnectionStrings.ConnectionStrings.Remove(newName);
            }
            // 將新的連接串添加到配置文件中.
            config.ConnectionStrings.ConnectionStrings.Add(mySettings);
            // 保存對配置文件所作的更改
            config.Save(ConfigurationSaveMode.Modified);
            // 強制重新載入配置文件的ConnectionStrings配置節
            ConfigurationManager.RefreshSection("ConnectionStrings");
        }
    }
}

最后右擊項目選擇“添加－新建項”，然后選擇“應用程序配置文件”，點擊添加按鈕就創建配置文件app.config。

app.config的格式如下：

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <appSettings>
    <add key="SosoftKey" value="sosoftValue" />
    <add key="SosoftURL" value="sosoft.cnblogs.com" />
    <add key="SosoftProject" value="sosoft.codeplex.com" />
  </appSettings>
</configuration>

按F5運行，可以添加、修改appSettings配置項和列出所有appSettings配置項。

 

柔城配置文件讀寫實例源代碼下載地址：http://files.cnblogs.com/sosoft/SosoftConfig.rar