首先通过IConfiguration接口读取appsettings.json配置,需确保文件正确设置并复制到输出目录;在.net 6+中使用WebApplication.CreateBuilder自动加载配置,通过builder.Configuration获取连接字符串或层级键值;支持冒号分隔语法读取嵌套配置,并可将配置绑定到强类型类(如AppSettings),通过services.Configure<T>注册并在控制器中注入IOptions<T>使用;注意区分环境配置文件(如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<AppSettings>(builder.Configuration.GetSection("AppSettings"));
在控制器或其他服务中通过 IOptions<T> 注入使用:
public class HomeController : Controller { private readonly AppSettings _appSettings; public HomeController(IOptions<AppSettings> 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)或环境变量,避免提交到代码库。
基本上就这些。只要正确设置文件和依赖注入,读取配置非常简单。


