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

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

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