WPF 程序中的 App.Config 文件读写操作详解

一、 App.Config 文件的作用与结构#

在 WPF 应用程序中，App.Config 是管理静态配置的标准方式。它本质上是一个 XML 文件，编译后会重命名为 你的程序名.exe.config 并存放在运行目录下。

常见的结构包含 appSettings（简单键值对）和 connectionStrings（数据库连接字符串）：

1
<?xml version="1.0" encoding="utf-8" ?>
2
<configuration>
3
  <appSettings>
4
    <add key="ServerIp" value="192.168.1.100"/>
5
    <add key="UnitWidth" value="1920"/>
6
  </appSettings>
7

8
  <connectionStrings>
9
    <add name="DefaultDb" connectionString="Server=.;Database=Test;Integrated Security=True;"/>
10
  </connectionStrings>
11
</configuration>

二、基础操作：使用 ConfigurationManager#

在 WPF 中操作配置，首先需要在项目中引用 System.Configuration 程序集。

1. 读取配置#

不要使用过时的 ConfigurationSettings。现代开发中应统一使用 ConfigurationManager。

1
using System.Configuration;
2

3
// 读取 appSettings
4
string ip = ConfigurationManager.AppSettings["ServerIp"];
5

6
// 读取 connectionStrings
7
string conn = ConfigurationManager.ConnectionStrings["DefaultDb"].ConnectionString;

2. 写入与更新配置#

写入操作通常用于软件的“设置”界面。需要注意：写入操作会直接修改磁盘上的 .exe.config 文件。

1
public static void UpdateSetting(string key, string value)
2
{
3
    // 打开配置文件
4
    Configuration config = ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None);
5

6
    // 如果存在则修改，不存在则添加
7
    if (config.AppSettings.Settings[key] != null)
8
    {
9
        config.AppSettings.Settings[key].Value = value;
10
    }
11
    else
12
    {
13
        config.AppSettings.Settings.Add(key, value);
14
    }
15

16
    // 保存并强制刷新缓存，确保下次读取到的是最新值
17
    config.Save(ConfigurationSaveMode.Modified);
18
    ConfigurationManager.RefreshSection("appSettings");
19
}

三、进阶：使用 XmlDocument 处理自定义节点#

当配置文件包含复杂的自定义节点（如 eas、entityFramework）时，标准的 ConfigurationManager 可能无法直接修改。此时我们可以将 .config 作为纯 XML 文件进行操作。

示例：动态解析并修改嵌套属性#

假设我们需要修改深度嵌套的 Url 属性：

1
public void UpdateCustomSection(string newIp)
2
{
3
    // 获取编译后的配置文件路径
4
    string path = AppDomain.CurrentDomain.SetupInformation.ConfigurationFile;
5

6
    XmlDocument xmlDoc = new XmlDocument();
7
    xmlDoc.Load(path);
8

9
    // 定位到自定义节点
10
    XmlNode node = xmlDoc.SelectSingleNode("configuration/eas/objects/object/property[@name='Url']");
11

12
    if (node != null)
13
    {
14
        // 假设原值为 socket.tcp://127.0.0.1:1000/
15
        string oldValue = node.Attributes["value"].Value;
16
        // 执行字符串替换或重新构建
17
        node.Attributes["value"].Value = $"socket.tcp://{newIp}:1000/";
18

19
        xmlDoc.Save(path);
20
        ConfigurationManager.RefreshSection("eas"); // 刷新自定义段
21
    }
22
}

四、开发中的常见坑点（注意事项）#

调试环境 vs 运行环境：

在 Visual Studio 中点击“启动”时，程序修改的是 bin/Debug 下的 .config。
每次重新编译，VS 都会用项目源码里的 App.config 覆盖掉输出目录下的文件。因此，测试写入功能后，不要立即重新编译。

权限问题：

如果程序安装在 C:\Program Files 目录下，修改配置文件可能需要 管理员权限。建议将用户级别的配置存在 AppData 目录下，而不是 App.Config 中。

类型转换：

AppSettings 返回的永远是 string。对于数字、布尔值，需要手动进行 int.Parse 或 Convert.ToBoolean。

五、总结#

App.Config 是 WPF 存储静态配置的基石。对于简单的参数，使用 ConfigurationManager 即可高效处理；对于复杂的第三方框架节点，灵活运用 XmlDocument 能解决绝大多数问题。

一、 App.Config 文件的作用与结构#

二、 基础操作：使用 ConfigurationManager#