Dapper的连接字符串在哪里配置 ASP.NET Core Dapper连接配置

来源：这里教程网时间：2026-02-21 17:35:57 作者：

ASP.NET Core 中 Dapper 本身不管理连接字符串，它只是一个轻量级的 ORM 工具，依赖

IDbConnection

（如

SqlConnection

）来执行 SQL。所以“Dapper 的连接字符串”实际就是你数据库的连接字符串，配置位置和方式与 ASP.NET Core 的标准数据库配置完全一致——统一在
appsettings.json
中定义，再通过
IConfiguration
注入或读取。

1. 在 appsettings.json 中配置连接字符串

这是最常用、推荐的方式。在项目根目录的

appsettings.json

文件中添加：

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=MyAppDb;Trusted_Connection=true;MultipleActiveResultSets=true;"
  }
}

注意：

ConnectionStrings

是约定名称，可自定义，但需与后续读取代码保持一致。

2. 在 Program.cs（或 Startup.cs）中注册服务（可选）

如果你希望把连接字符串封装为一个可注入的服务（比如提供

SqlConnection

实例），可以在

Program.cs

中这样写：

直接读取并注册为单例（适合简单场景）：

var connectionString = builder.Configuration.GetConnectionString("DefaultConnection");
builder.Services.AddSingleton<string>(connectionString);

更推荐：注册
SqlConnection
工厂（避免连接复用问题）：

builder.Services.AddTransient<IDbConnection>(sp =>
{
    var conn = new SqlConnection(connectionString);
    conn.Open(); // 可选：按需打开，通常建议在使用时再 Open
    return conn;
});

⚠️ 注意：不建议将

SqlConnection

注册为

Singleton

，因为连接对象不是线程安全的，且可能被意外关闭或超时。

3. 在 Repository 或 Service 中使用连接字符串

实际使用 Dapper 时，一般在仓储类中通过构造函数注入

IConfiguration

或已注册的连接工厂：

方式一：注入
IConfiguration
，按需创建连接（最灵活）：

public class ProductRepository
{
    private readonly IConfiguration _config;
    public ProductRepository(IConfiguration config) => _config = config;
<pre class="brush:php;toolbar:false;">public async Task<IEnumerable<Product>> GetAll()
{
    var connStr = _config.GetConnectionString("DefaultConnection");
    using var conn = new SqlConnection(connStr);
    return await conn.QueryAsync<Product>("SELECT * FROM Products");
}

}

方式二：注入
IDbConnection
（前提是已注册为
Transient
）：

public class ProductRepository
{
    private readonly IDbConnection _conn;
    public ProductRepository(IDbConnection conn) => _conn = conn;
<pre class="brush:php;toolbar:false;">public async Task<IEnumerable<Product>> GetAll() =>
    await _conn.QueryAsync<Product>("SELECT * FROM Products");

}

✅ 推荐方式一，因为它确保每次查询都使用新连接，符合 Dapper “轻量、显式、控制权在开发者手中”的设计哲学。