当前位置:

首页 > 编程开发 > C#怎么实现配置文件读写_C#如何读取App.config和appsettings.json【教程】

C#怎么实现配置文件读写_C#如何读取App.config和appsettings.json【教程】

PSD Manager Windows版
PSD Manager Windows版

PSD Manager是适用于Windows版Autodesk 3ds Max的渲染后期插件,可把画面、渲染元素、对象及材质蒙版整理成分层PSD或PSB文件,便于在Photoshop、Affinity Photo和After Effects

立即下载
Windows 2026-10-15
视频编辑 三维设计

C#怎么实现配置文件读写_C#如何读取App.config和appsettings.json【教程】 开门见山,先说一个核心结论:App.config 在现代 .NET 开发中已经出局,而 appsettings.json 虽然是标准,但它的设计初衷是“只读”的。 这意味着,如果你想让应用在运行时动

本文目录

    C#怎么实现配置文件读写_C#如何读取App.config和appsettings.json【教程】

    C#怎么实现配置文件读写_C#如何读取App.config和appsettings.json【教程】

    开门见山,先说一个核心结论:App.config 在现代 .NET 开发中已经出局,而 appsettings.json 虽然是标准,但它的设计初衷是“只读”的。 这意味着,如果你想让应用在运行时动态修改配置并持久化保存,指望框架自动帮你双向同步,那可就找错方向了。真正的解决方案,是手动构建配置对象并直接操作 JSON 文件本身。

    App.config 在现代 C# 项目里根本不能“写”

    首先得明确,App.config 是 .NET Framework 时代的产物。那时候,大家习惯用 ConfigurationManager.AppSettings[“key”] 来读取配置,感觉挺方便。但问题在于,这个机制从设计上就是只读的。你或许尝试过修改值然后调用 Sa ve(),结果发现要么不生效,要么只在当前进程内存里变了一下,应用一重启,改动就全丢了。

    到了 .NET Core / .NET 5+ 的时代,情况就更彻底了:

    • 新建的 .NET 6/7/8 项目,默认根本不会包含 App.config 文件。
    • 即便你手动添加一个,运行时也不会自动加载它。
    • 更关键的是,即便你强行想用旧方法,比如调用 ConfigurationManager.OpenExeConfiguration,在 .NET Core+ 平台上,等待你的很可能是一个 PlatformNotSupportedException 异常。Visual Studio 编译时确实会把 App.config 复制为 MyApp.exe.config,但运行时根本不会监听这个文件的任何变更。

    所以,结论很清晰:对于新项目,App.config 这条路可以直接放弃了。

    appsettings.json 只能读,不能直接写

    既然 App.config 不行,那转向标准的 appsettings.json 总可以了吧?很遗憾,这里也有一个常见的误解。我们通过依赖注入拿到的 IConfiguration 接口,它提供的是 GetSection()、GetValue() 等一系列读取方法,但翻遍文档,你也找不到一个官方的 Set() 或 Sa ve() 方法。

    这是为什么呢?因为 IConfiguration 本质上是一个配置源的只读快照。它的背后可能串联着 JSON 文件、环境变量、命令行参数、内存字典等多个来源。这种设计是为了灵活性和优先级合并,但也意味着它没有“写回”某个特定源(比如 JSON 文件)的职责。

    • 如果你试图通过一些“黑魔法”(比如强制转换类型)去修改 IConfiguration 实例内部的状态,这属于未公开的行为,不同版本的 .NET SDK 可能导致不可预知的后果,甚至程序崩溃。
    • 当然,你可以手动用 JsonSerializer.Serialize() 把配置写回 JSON 文件,但这意味着你必须自己处理一堆麻烦事:并发写入冲突、保持 JSON 的格式缩进、处理注释丢失等等。
    • 还有一个棘手的问题:如果你的配置项混合了多个来源(比如数据库连接字符串来自 appsettings.json,而日志级别来自环境变量),那么“写回文件”这个操作本身就无法还原这种复杂的来源逻辑。

    所以,appsettings.json 本身不是用来“写”的,IConfiguration 也不是那个负责持久化的对象。

    真要实现“可写配置”,得绕过 IConfiguration 直接操作 JSON 文件

    那么,正确的姿势到底是什么?答案是:绕过 IConfiguration 的只读抽象层,直接对 appsettings.json 这个物理文件进行读写操作。 这是最可控、最可预测的方法。

    具体步骤可以分解如下:

    • 读取与解析:首先,使用 File.ReadAllText(“appsettings.json”) 将文件内容完整读入,然后通过 System.Text.Json 或 Newtonsoft.Json 将其反序列化。你可以反序列化为灵活的 JsonDocument,或者更常见的,映射到一个预先定义好的 POCO(普通C#类)模型上。
    • 修改配置:在内存中修改这个模型对象的属性值,比如 settings.Logging.LogLevel.Default = “Debug”;。
    • 写回与重载:使用 JSON 序列化器将修改后的对象重新序列化为字符串,并用 File.WriteAllText 写回原文件。这里有个关键点:为了保持文件可读性,建议在序列化时设置 WriteIndented = true。写入完成后,调用之前保存的 IConfigurationRoot.Reload() 方法,触发配置系统重新加载文件,使改动立即生效。
    // 构建配置时,确保获取到 IConfigurationRoot 的引用
    var config = new ConfigurationBuilder()
        .AddJsonFile(“appsettings.json”, optional: false, reloadOnChange: true)
        .Build();
    var root = (IConfigurationRoot)config;
    
    // 直接读写 JSON 文件
    var settings = JsonSerializer.Deserialize(File.ReadAllText(“appsettings.json”));
    settings.Logging.LogLevel.Default = “Debug”;
    File.WriteAllText(“appsettings.json”, JsonSerializer.Serialize(settings, new JsonSerializerOptions { WriteIndented = true }));
    
    // 触发配置重载
    root.Reload();
    

    需要提醒的是,在写回文件前,强烈建议对原文件进行备份。这样可以防止万一序列化过程出错导致 JSON 格式损坏,从而避免应用下次启动时直接失败。

    别忽略 reloadOnChange 和文件权限这两个硬限制

    即使你按照上面的流程操作,还有两个底层限制必须心里有数,它们常常在部署后成为“幽灵问题”。

    第一个是关于 reloadOnChange: true。这个选项依赖于 FileSystemWatcher 来监听文件变化,但它并非百分百可靠:

    • 在 Docker 容器环境中,尤其是 Windows 主机搭配 Linux 容器时,挂载卷(Volume)的文件变更事件经常无法正确触发。
    • 如果 appsettings.json 文件被其他进程(如 Visual Studio 正在编辑,或者记事本没有关闭)以独占方式打开,重载可能会静默失败。

    第二个,也是更实际的限制,是文件系统权限。

    • 在 Linux 系统上部署时,如果运行应用的用户(比如 www-data)没有对 appsettings.json 文件的读取权限,应用在启动阶段就会抛出 UnauthorizedAccessException,根本到不了运行时。
    • 而“写”配置时,问题更突出:appsettings.json 通常位于应用程序集相同的目录。在生产环境中,无论是 Linux 的 systemd 服务还是 Windows 服务,其运行账户默认往往没有对该目录的写入权限。如果你没提前配置好权限,写文件时会直接抛出异常。

    所以,在实现可写配置功能的同时,务必把权限检查和异常处理纳入考量范围,这才是真正稳健的做法。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 PS
    相关文章 更多
    PS怎么去文字水印不影响原图
    PS怎么去文字水印不影响原图

    学习如何在Photoshop中使用内容识别填充去除文字水印。通过新建图层和精确取样,在不破坏原图文件的前提下修复背景,适合处理简单背景下的日期或文字水印。

    PS反选功能有哪些实例
    PS反选功能有哪些实例

    详解Photoshop中“反选”命令的实际应用场景。通过白底水壶案例,演示如何利用魔棒工具配合反选实现主体提取,以及如何利用快速选择工具配合反选实现背景局部调色。包含图层蒙版修饰技巧,适合PS初学者掌握非破坏性编辑流程。

    PS笔刷怎么调成两头尖
    PS笔刷怎么调成两头尖

    想在Photoshop中画出两头尖中间粗的线条?本教程详解如何设置画笔大小动态为钢笔压力,并利用路径描边的模拟压力功能,在无数位板情况下也能轻松实现两端收尖的笔画效果。

    PS网页版登录入口在哪里
    PS网页版登录入口在哪里

    找不到 PS 网页版登录入口?直接访问 photoshop.adobe.com 即可进入官方页面。本文详解如何使用 Adobe 账户登录、区分试用与付费权限,以及解决浏览器兼容和存储限制等常见问题,避免误入第三方站点。

    PS快捷键表格图片在哪找
    PS快捷键表格图片在哪找

    找不到准确的 PS 快捷键大全图片?本文演示如何在 Windows 版 Photoshop 中通过官方帮助和软件内部设置查看真实键位,导出 HTML 列表并制作专属快捷键表格,确保信息准确且适用于当前版本。

    PS抠图常用工具是什么
    PS抠图常用工具是什么

    详解Photoshop中快速选择、魔棒、钢笔等抠图工具的适用场景。通过杯子实例,展示从建立选区到添加图层蒙版、换底检查及保存透明PNG的完整流程,确保边缘干净且文件可二次编辑。

    PS反选的快捷键是什么
    PS反选的快捷键是什么

    想知道PS反选的快捷键是什么?Windows系统下只需按下Ctrl+Shift+I即可快速反向选择区域。本教程详解操作步骤、蒙版验证方法及与反相、取消选择的区别,助你高效处理选区。

    PS去水印怎么不伤原图
    PS去水印怎么不伤原图

    详解如何在Photoshop中使用仿制图章工具和空白修复层去除水印,通过设置取样来源和图层蒙版,实现非破坏性编辑,保留原图完整性和可撤回修改能力。

    PS反选快捷键在Mac上是什么
    PS反选快捷键在Mac上是什么

    想知道Mac上PS反选快捷键是什么?默认组合为Command+Shift+I。本文通过具体案例,演示如何利用该快捷键交换选区范围,配合图层蒙版快速抠图,并解决常见误操作问题。

    PS笔刷设置怎么恢复默认
    PS笔刷设置怎么恢复默认

    遇到PS笔刷画不出线条或预设丢失?本文详解Windows版Photoshop中如何安全备份ABR文件、复位画笔工具选项及恢复默认笔刷库,避免误删自定义资源。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。

    即将离开本站
    您即将前往第三方网站,请确认是否继续?