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

直接安装 NuGet 包即可在 .NET Framework 4.5.1+ 项目中使用 Dapper，执行 Install-Package Dapper；若为 4.0 则需 Install-Package Dapper -Version 1.50.5，并引用 using Dapper;，通过 IDbConnection 实例调用扩展方法，支持命名参数防 SQL 注入，兼容旧数据层但需避免连接复用与混用。

直接安装 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 容器，老项目接入零侵入。

# app # .net # sql # 命名空间 # select # 字符串 # 接口 # using # var # 并发 # 对象 # visual studio # linq # 复用 # 的是 # 也不 # 多个 # 不需要 # 已有 # 可在 # 挂在 # 管理器 # 只是一个

返回目录在线咨询

上一篇：Android自定义扇形倒计时实例代码
下一篇：详解azure 云上准备oracle11g的vnc安装环境

您的项目需求