Dapper怎么在.NET Framework中使用 Dapper老项目集成指南

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

直接安装 NuGet 包即可开始使用

在 .NET Framework 项目中集成 Dapper 非常简单，不需要额外配置运行时或修改项目文件（只要版本 ≥ 4.5.1）。打开 Visual Studio 的“包管理器控制台”，执行：

Install-Package Dapper —— 安装最新稳定版（支持 .NET Framework 4.5.1 及以上）如果项目用的是较老的 .NET Framework 4.0，可安装旧版：Install-Package Dapper -Version 1.50.5

引用命名空间并确认连接可用

在代码文件顶部添加：

using Dapper;

确保你已有 IDbConnection 实例（比如 SqlConnection），Dapper 所有扩展方法都挂在这个接口上。常见写法：

用 using (var conn = new SqlConnection(connectionString)) 确保及时释放 不要复用未关闭的连接，Dapper 不负责连接生命周期管理 连接字符串建议从 ConfigurationManager.ConnectionStrings 读取

基础查询与参数化防 SQL 注入

Dapper 默认使用命名参数（推荐），自动处理类型映射和参数转义：

conn.Query("SELECT * FROM Users WHERE Id = @id", new { id = 123 }) 多个参数直接传匿名对象：new { name = "张三", status = 1 } 避免拼接字符串，不写
"WHERE Id = " + id
—— 这会绕过参数化，引发安全风险

注意老项目常见兼容问题

部分传统 .NET Framework 项目可能存在以下情况，需手动检查：

目标框架是 .NET Framework 4.0 或更低 → 必须降级到 Dapper 1.50.x 版本 项目启用了 嵌套类型（Nested Types）或 COM 互操作 → 确保 Dapper 引用无冲突，可尝试清理 bin/obj 后重装 使用了 Enterprise Library、LINQ to SQL 等旧数据层 → Dapper 可共存，但别混用同一连接实例做并发操作

基本上就这些。Dapper 本身只是一个轻量扩展库，不改写你的连接逻辑，也不依赖 DI 容器，老项目接入零侵入。