C# 怎么使用 Dapper 连接数据库_C# Dapper 数据库连接操作教程

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

Dapper 是一个轻量级的 ORM（对象关系映射）工具，适用于 C# 和 .NET 平台。它在性能上优于 Entity Framework 等重量级框架，特别适合需要高效执行 SQL 查询的场景。使用 Dapper 连接数据库非常简单，只需要通过 ADO.NET 提供的 IDbConnection 接口即可实现。

1. 安装 Dapper

在项目中使用 Dapper 前，需先通过 NuGet 安装 Dapper 包：

打开 NuGet 包管理器控制台，运行以下命令：

Install-Package Dapper

安装完成后，就可以在代码中引用 Dapper 命名空间了。

2. 配置数据库连接字符串

在 appsettings.json 或配置文件中添加数据库连接信息。例如，使用 SQL Server 时：

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=TestDB;User Id=sa;Password=your_password;TrustServerCertificate=true;"
  }
}

在程序启动时读取该连接字符串，通常在 Program.cs 或 Startup.cs 中处理（根据 .NET 版本不同）。

3. 使用 Dapper 执行数据库操作

下面以 SQL Server 为例，演示如何使用 Dapper 进行常见数据库操作。

示例：查询数据

假设有一个 User 表，对应实体类如下：

public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
    public string Email { get; set; }
}

使用 Dapper 查询所有用户：

using (var connection = new SqlConnection(connectionString))
{
    var users = connection.Query<User>("SELECT * FROM Users");
    foreach (var user in users)
    {
        Console.WriteLine($"{user.Id}: {user.Name} - {user.Email}");
    }
}

示例：插入数据

使用参数化 SQL 防止注入攻击：

var sql = "INSERT INTO Users (Name, Email) VALUES (@Name, @Email)";
using (var connection = new SqlConnection(connectionString))
{
    var affectedRows = connection.Execute(sql, new { Name = "张三", Email = "zhangsan@example.com" });
    Console.WriteLine($"插入了 {affectedRows} 条记录");
}

示例：更新数据

var sql = "UPDATE Users SET Email = @Email WHERE Id = @Id";
using (var connection = new SqlConnection(connectionString))
{
    var updated = connection.Execute(sql, new { Id = 1, Email = "newemail@example.com" });
    Console.WriteLine($"更新了 {updated} 条记录");
}

示例：删除数据

var sql = "DELETE FROM Users WHERE Id = @Id";
using (var connection = new SqlConnection(connectionString))
{
    var deleted = connection.Execute(sql, new { Id = 1 });
    Console.WriteLine($"删除了 {deleted} 条记录");
}

4. 注意事项与最佳实践

始终使用 using 语句确保数据库连接正确释放 避免拼接 SQL 字符串，使用 Dapper 的参数化机制防止 SQL 注入 Dapper 不支持自动迁移，表结构需手动创建或配合其他工具管理 对于复杂查询，Dapper 支持多结果集映射（QueryMultiple）、事务操作等高级功能

基本上就这些。Dapper 的优势在于简洁和高性能，适合熟悉 SQL 又希望减少 ADO.NET 模板代码的开发者。掌握基本的 Query、Execute 方法后，就能快速完成大多数数据库操作任务。