Dapper在WinForms中使用需三步：安装Dapper及对应数据库驱动；封装DataAccess类统一管理连接字符串、使用using确保连接释放、避免UI线程阻塞；调用时用async/await+Task.Run异步查询，通过this.Invoke更新控件，并注意增删改的事务与异常处理。
Dapper 本身不区分 WinForms、WPF 或控制台，它只是一个轻量级的 .NET ORM，专做 SQL 映射。在 WinForms 中用 Dapper，核心就三件事：装包、建连接、写 SQL + 实体类。不复杂，但容易忽略线程和 UI 安全问题。
1. 引入 Dapper 和数据库驱动
打开 NuGet 包管理器，安装两个必要包：
- Dapper（核心映射库）
- Microsoft.Data.SqlClient（SQL Server）或 MySqlConnector（MySQL）、Npgsql（PostgreSQL）——选你实际用的数据库驱动
比如用 SQL Server，安装后代码里加引用：
// 在 Form 或数据访问类顶部using Dapper;
using Microsoft.Data.SqlClient;
2. 封装一个安全的数据访问类
别把 SqlConnection 写满整个窗体。建议单独建个 DataAccess.cs，封装常用操作：
- 用
static string ConnectionString统一管理连接字符串（可从 app.config 或 settings.settings 读） - 所有查询方法都用
using var conn = new SqlConnection(...)确保及时释放 - 避免在 UI 线程直接执行耗时查询（比如查几千条记录），否则界面卡死
示例：查用户列表
// DataAccess.cspublic static List
{
using var conn = new SqlConnection(ConnectionString);
return conn.Query
}
3. 在 WinForms 中调用并更新控件
WinForms 默认是单线程 UI 模型，不能跨线程改控件（比如在 Task 里直接赋值 dataGridView1.DataSource = list 会报错）。安全做法：
- 简单场景：用
this.Invoke()回到 UI 线程 - 稍复杂场景：用
async/await + Task.Run()把查询移出 UI 线程
推荐写法（兼顾响应性和安全性）：
// Form1.cs 中的按钮点击事件private async void btnLoadUsers_Click(object sender, EventArgs e)
{
btnLoadUsers.Enabled = false;
try
{
var users = await Task.Run(() => DataAccess.GetUsers());
this.Invoke((MethodInvoker)delegate { dataGridView1.DataSource = users; });
}
finally
{
btnLoadUsers.Enabled = true;
}
}
4. 增删改也要注意事务和异常
插入、更新、删除别只写 Execute() 就完事。关键点：
- 涉及多步操作（比如先插主表再插子表），用
conn.BeginTransaction() - 所有
Execute调用都要检查返回值（影响行数），判断是否成功 - 捕获
SqlException并给用户友好提示，而不是弹出原始错误信息
例如添加用户：
public static bool InsertUser(User user){
using var conn = new SqlConnection(ConnectionString);
const string sql = "INSERT INTO Users (Name, Email) VALUES (@Name, @Email);";
return conn.Execute(sql, user) > 0;
}
基本上就这些。Dapper 在 WinForms 里没有魔法，就是“手写 SQL + 自动映射 + 注意线程”。用熟了比 DataSet 更快更可控，也比 Entity Framework 更轻量。
