C# 怎么读取应用程序的配置文件 appsettings.json_C# appsettings.json 配置文件读取方法

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

C# 怎么读取应用程序的配置文件 appsettings.json_C# appsettings.json 配置文件读取方法

2025-11-01

浏览次数：次

返回列表

答案是使用 Microsoft.Extensions.Configuration 读取 appsettings.json。首先安装 Microsoft.Extensions.Configuration.Json 包，创建并配置 appsettings.json 文件属性为“如果较新则复制”，通过 ConfigurationBuilder 设置基路径并加载 JSON 文件，利用 IConfigurationRoot 读取配置值，支持冒号语法访问嵌套节点，并可将配置节绑定到强类型对象如 AppSettings 类，实现类型安全的配置管理。

c# 怎么读取应用程序的配置文件 appsettings.json_c# appsettings.json 配置文件读取方法

在 C# 中读取 appsettings.json 配置文件，通常使用 .NET 的配置系统（Microsoft.Extensions.Configuration）。这个方法适用于 Console 应用、ASP.NET Core 以及其他支持该扩展的项目类型。下面介绍如何正确加载和读取 appsettings.json 文件中的配置。

1. 添加必要的 NuGet 包引用

确保项目中安装了以下 NuGet 包：

Microsoft.Extensions.Configuration
Microsoft.Extensions.Configuration.Json

可以通过 NuGet 包管理器或命令行安装：

dotnet add package Microsoft.Extensions.Configuration.Json

2. 创建 appsettings.json 文件

在项目根目录添加一个名为 appsettings.json 的文件，并设置其“复制到输出目录”属性为“如果较新则复制”。

示例内容如下：

{ "AppSettings": { "SiteName": "MyWebsite", "Version": "1.0.0", "ConnectionString": "Server=localhost;Database=MyDB;Trusted_Connection=true;" }, "Logging": { "LogLevel": "Information" } }

右键点击该文件，在属性中确认“复制到输出目录”为“始终复制”或“如果较新则复制”，确保运行时能访问到它。

3. 使用 ConfigurationBuilder 读取配置

在程序中使用 ConfigurationBuilder 构建配置对象，然后读取值。

示例代码（以 Console 应用为例）：

短影AI

长视频一键生成精彩短视频

170 查看详情短影AI

using Microsoft.Extensions.Configuration;
using System;

var builder = new ConfigurationBuilder()
.SetBasePath(Directory.GetCurrentDirectory())
.AddJsonFile("appsettings.json", optional: false, reloadOnChange: true);

IConfigurationRoot configuration = builder.Build();

string siteName = configuration["AppSettings:SiteName"];
string version = configuration["AppSettings:Version"];
string connectionString = configuration["AppSettings:ConnectionString"];

Console.WriteLine($"站点名称: {siteName}");
Console.WriteLine($"版本: {version}");
Console.WriteLine($"连接字符串: {connectionString}");

这里通过冒号（:）语法访问嵌套节点，如 AppSettings:SiteName。

4. 绑定配置到强类型对象

定义一个类来映射配置结构：

public class AppSettings
{
public string SiteName { get; set; }
public string Version { get; set; }
public string ConnectionString { get; set; }
}

然后使用 Bind 方法或 GetSection().Get() 映射配置：

var appSettings = new AppSettings();
configuration.GetSection("AppSettings").Bind(appSettings);
// 或者：
// var appSettings = configuration.GetSection("AppSettings").Get();

这样就可以像操作普通对象一样使用配置项了。

基本上就这些。只要引入正确的包、配置好 JSON 文件路径并使用 ConfigurationBuilder，就能轻松读取 appsettings.json 中的内容。这种方式灵活且符合现代 .NET 开发规范。

以上就是C# 怎么读取应用程序的配置文件 appsettings.json_C# appsettings.json 配置文件读取方法的详细内容，更多请关注其它相关文章！