Dapper在WinForms项目中怎么用 Dapper桌面应用开发教程

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.cs
public static List GetUsers()
{
  using var conn = new SqlConnection(ConnectionString);
  return conn.Query("SELECT Id, Name, Email FROM Users").ToList();
}

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 更轻量。