.NET Core Web API如何在应用配置JSON中设置本地目录路径

1. 在应用设置中配置本地目录路径 #

直接在项目的appsettings.json（或对应环境的配置文件，如appsettings.Development.json）中添加自定义配置节点：

{
  "AppSettings": {
    "XmlStoragePath": "C:\\LocalXmlFiles\\Data"
  }
}

• 如果使用相对路径（比如项目根目录下的子文件夹），可以写成："./XmlData"，Windows和Linux环境都能兼容
• 不同环境可在对应配置文件中设置不同路径，开发环境用本地测试路径，生产环境用部署服务器上的路径

2. 引用配置路径替代硬编码 #

有两种常用方式，按需选择：

方式一：直接注入IConfiguration读取 #

.NET Core默认已注册IConfiguration服务，直接在需要使用路径的类中注入即可：

using Microsoft.Extensions.Configuration;

public class XmlCrudService
{
    private readonly IConfiguration _config;

    // 构造函数注入IConfiguration
    public XmlCrudService(IConfiguration config)
    {
        _config = config;
    }

    public void CreateXmlFile()
    {
        // 读取配置中的路径
        string storagePath = _config["AppSettings:XmlStoragePath"];
        // 可结合Path类确保路径合法性，比如转为绝对路径
        string fullPath = Path.GetFullPath(storagePath);
        // 后续执行CRUD操作...
    }
}

方式二：绑定到强类型配置类（推荐） #

这种方式更规范，便于维护和类型校验：

1. 创建配置实体类：

public class AppSettings
{
    public string XmlStoragePath { get; set; }
}

2. 在Program.cs（.NET 6+）或Startup.cs（.NET 5及更早）中注册配置绑定：

// .NET 6+ Program.cs
var builder = WebApplication.CreateBuilder(args);
// 绑定AppSettings节点到强类型类
builder.Services.Configure<AppSettings>(builder.Configuration.GetSection("AppSettings"));

3. 在业务类中注入IOptions<AppSettings>读取路径：

using Microsoft.Extensions.Options;

public class XmlCrudService
{
    private readonly string _xmlStoragePath;

    public XmlCrudService(IOptions<AppSettings> appSettings)
    {
        // 获取配置值，可提前做非空校验
        _xmlStoragePath = appSettings.Value.XmlStoragePath 
            ?? throw new ArgumentNullException(nameof(appSettings.Value.XmlStoragePath));
        // 转为绝对路径确保正确性
        _xmlStoragePath = Path.GetFullPath(_xmlStoragePath);
    }

    // 后续CRUD操作直接使用_xmlStoragePath变量即可
}

内容的提问来源于stack exchange，提问作者mrs15