首先通过IConfiguration接口读取appsettings.json配置，需确保文件正确设置并复制到输出目录；在.NET 6+中使用WebApplication.CreateBuilder自动加载配置，通过builder.Configuration获取连接字符串或层级键值；支持冒号分隔语法读取嵌套配置，并可将配置绑定到强类型类（如AppSettings），通过services.Configure注册并在控制器中注入IOptions使用；注意区分环境配置文件（如appsettings.Development.json）并优先使用用户机密或环境变量存储敏感信息。
在 .NET 应用程序中读取 appsettings.json 中的配置信息，主要依赖于 IConfiguration 接口。以下是具体实现步骤和常用方法。
1. 确保 appsettings.json 正确配置
首先，在项目根目录下创建或确认存在 appsettings.json 文件，并设置“复制到输出目录”为“如果较新则复制”。示例内容如下：
{
"ConnectionStrings": {
"DefaultConnection": "Server=localhost;Database=MyDb;Trusted_Connection=true"
},
"AppSettings": {
"SiteName": "My Website",
"PageSize": 20
},
"Logging": {
"LogLevel": {
"Default": "Information"
}
}
}
2. 在 Program.cs 或 Startup 中注入配置服务
.NET 6 及以上版本使用最小 API 模式，Program.cs 自动构建配置。你无需手动加载，IConfiguration 已经可用。
例如：
var builder = WebApplication.CreateBuilder(args);
// 直接通过 builder.Configuration 使用配置
var connectionString = builder.Configuration.GetConnectionString("DefaultConnection");
var siteName = builder.Configuration["AppSettings:SiteName"];
var app = builder.Build();
如果你使用的是早期版本（如 .NET Core 3.1），在 Startup.cs 的构造函数中接收 IConfiguration 实例：
public class Startup
{
public IConfiguration Configuration { get; }
public Startup(IConfiguration configuration)
{
Configuration = configuration;
}
}
3. 读取配置值的常用方式
你可以通过多种方式从 IConfiguration 获取值：
-
获取连接字符串：
string conn = Configuration.GetConnectionString("DefaultConnection"); -
通过冒号分隔键读取层级配置：
string name = Configuration["AppSettings:SiteName"];int pageSize = int.Parse(Configuration["AppSettings:PageSize"]); -
绑定到强类型对象：
创建一个类来映射配置结构：
public class AppSettings
{
public string SiteName { get; set; }
public int PageSize { get; set; }
}
然后在 Program.cs 或 Startup.cs 中绑定：
builder.Services.Configure(builder.Configuration.GetSection("AppSettings"));
在控制器或其他服务中通过 IOptions
public class HomeController : Controller
{
private readonly AppSettings _appSettings;
public HomeController(IOptions appSettings)
{
_appSettings = appSettings.Value;
}
public IActionResult Index()
{
ViewBag.SiteName = _appSettings.SiteName;
return View();
}
}
4. 注意事项
- 确保 appsettings.json 的“生成操作”为 Content，“复制到输出目录”为“如果较新则复制”。
- 环境特定配置可使用 appsettings.Development.json、appsettings.Production.json，它们会自动覆盖主配置。
- 敏感信息建议使用用户机密（User Secrets）或环境变量，避免提交到代码库。
