如何在C#项目的app.config文件中添加文件路径并读取使用

算力阿峰

2026-9-30

C#项目将文件路径存入app.config的实现方法

1. 修改app.config配置文件

在项目的app.config文件的<configuration>根节点下，新增<appSettings>节点，按key-value格式存储你需要的路径：

<configuration>
  <!-- 其他已有配置节点保留 -->
  <appSettings>
    <!-- key为自定义的路径唯一标识，value为实际文件/文件夹路径 -->
    <add key="ReportTemplatePath" value="D:\Business\Templates\report.xlsx" />
    <add key="ExportOutputPath" value="C:\ExportFiles\2024\" />
  </appSettings>
</configuration>

路径支持相对路径写法，比如value="Templates\report.xlsx"，会自动相对于程序运行的根目录拼接路径。

2. 项目添加程序集引用

要读取app.config内容需要先引用System.Configuration组件：

右键你的项目 -> 选择「添加」->「引用」
在程序集列表中找到System.Configuration，勾选后点击确认
如果你使用的是.NET Core/.NET 5及更高版本，需要先安装NuGet包System.Configuration.ConfigurationManager，再进行引用

3. C#代码中读取路径

在需要使用路径的代码位置，通过ConfigurationManager类读取对应key的配置值即可：

using System;
using System.Configuration;

public class PathTest
{
    public void GetPathFromConfig()
    {
        // 读取配置中的路径
        string templatePath = ConfigurationManager.AppSettings["ReportTemplatePath"];
        string outputPath = ConfigurationManager.AppSettings["ExportOutputPath"];

        // 建议加非空校验，避免配置缺失导致异常
        if(string.IsNullOrEmpty(templatePath))
        {
            throw new Exception("配置文件中缺少ReportTemplatePath路径配置");
        }

        // 后续正常使用路径即可
        Console.WriteLine($"模板路径：{templatePath}");
    }
}