dapper是.net平台下的轻量级orm工具，性能优于entity framework，适合高效执行sql查询。1. 通过nuget安装dapper包；2. 在appsettings.json中配置数据库连接字符串；3. 使用idbconnection接口进行数据库操作，如query查询、execute插入更新删除；4. 遵循参数化查询防注入、using语句管理连接等最佳实践。
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 方法后，就能快速完成大多数数据库操作任务。
