0

0

Dapper如何实现增删改查 Dapper CRUD操作完整指南

幻夢星雲

幻夢星雲

发布时间:2026-01-01 02:39:09

|

596人浏览过

|

来源于php中文网

原创

Dapper通过Query、Execute等扩展方法配合原生SQL实现CRUD,不提供ORM抽象但支持参数化查询、自动对象映射、事务控制及自增ID获取;需注意SQL注入防护、影响行数校验与事务一致性。

dapper如何实现增删改查 dapper crud操作完整指南

Dapper 本身不提供“内置”的增删改查方法,而是通过扩展方法(如 Query、Execute)配合原生 SQL 实现高效、轻量的 CRUD 操作。它不做 ORM 映射层抽象,但用极简方式把 SQL 执行和对象映射封装得非常自然。

查询(Read):用 Query 获取单条或多条数据

Query 是最常用的方法,支持参数化查询,自动映射列名到对象属性(大小写不敏感,支持 [Column] 特性)。

  • 查多条:var users = conn.Query("SELECT * FROM Users WHERE Age > @age", new { age = 18 });
  • 查单条:var user = conn.QueryFirstOrDefault("SELECT * FROM Users WHERE Id = @id", new { id = 1 });
  • 查标量值(如 COUNT):var count = conn.ExecuteScalar("SELECT COUNT(*) FROM Users");

插入(Create):用 Execute 执行 INSERT 并获取自增 ID

Execute 返回受影响行数;若主键是数据库自增(如 SQL Server 的 IDENTITY),可用 SCOPE_IDENTITY() 获取刚插入的 ID。

  • 普通插入:conn.Execute("INSERT INTO Users (Name, Email) VALUES (@name, @email)", new { name = "张三", email = "zhang@example.com" });
  • 带返回 ID:var id = conn.QuerySingle("INSERT INTO Users (Name, Email) VALUES (@name, @email); SELECT CAST(SCOPE_IDENTITY() as int)", new { name = "李四", email = "li@example.com" });

更新与删除(Update / Delete):统一用 Execute + 参数化 SQL

Update 和 Delete 都属于“执行无结果集”的操作,全部走 Execute 方法,强调参数安全和影响行数校验。

Noya
Noya

让线框图变成高保真设计。

下载
  • 更新:int rows = conn.Execute("UPDATE Users SET Name = @name WHERE Id = @id", new { name = "王五", id = 1 }); if (rows == 0) throw new InvalidOperationException("未找到要更新的记录");
  • 删除:int deleted = conn.Execute("DELETE FROM Users WHERE Id = @id", new { id = 1 });
  • 软删除建议:UPDATE Users SET IsDeleted = 1 WHERE Id = @id —— Dapper 不管业务逻辑,只负责执行你写的 SQL。

批量操作与事务:用 Transaction 包裹多个 CRUD

Dapper 不封装批量插入(如 BulkInsert),但可轻松结合事务保证一致性。SQL Server 可搭配 SqlServerBulkCopy,或用 UNION ALL / 表值参数等原生方式。

  • 事务示例:using var tx = conn.BeginTransaction(); try { conn.Execute("INSERT...", new {...}, tx); conn.Execute("UPDATE...", new {...}, tx); tx.Commit(); } catch { tx.Rollback(); throw; }
  • 批量插入技巧(非 Dapper 原生):拼接多值 INSERT(适合几百条以内),或用 DataTable + SqlBulkCopy(需额外引用 System.Data.SqlClient 或 Microsoft.Data.SqlClient)。

基本上就这些。Dapper 的 CRUD 不复杂但容易忽略细节——比如不加参数化易被注入,不检查 Execute 返回值可能掩盖更新失败,不配事务导致数据不一致。写清楚 SQL,交给 Dapper 去执行和映射,就是它最稳的用法。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

675

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

319

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

345

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

1084

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

355

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

673

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

566

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

409

2024.04.29

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

7

2025.12.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Java 教程
Java 教程

共578课时 | 40万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号