Dapper的Execute方法的返回值是什么意思 Dapper Execute返回值详解

Dapper的Execute方法返回int类型，表示SQL命令实际影响的数据库行数；插入成功返回1，批量插入返回N，UPDATE/DELETE返回匹配行数，0表示无匹配或冲突未执行，不反映执行成功与否。

Dapper 的 Execute 方法返回的是一个 int 类型的整数，它表示该 SQL 命令**实际影响的数据库行数**，不是执行成功与否的布尔值，也不是主键 ID 或其他业务值。

返回值就是“受影响行数”

这个数字直接对应数据库执行后报告的 rows affected。例如：

• 插入一条新记录且成功 → 返回 1
• 批量插入 5 条，全部成功 → 返回 5
• UPDATE 语句匹配到 3 行，其中 2 行字段值实际发生了变化 → 多数数据库（如 SQL Server、PostgreSQL）仍返回 3（只要 WHERE 匹配就计数，不管是否真正更新了数据）
• DELETE 条件没匹配到任何行 → 返回 0
• INSERT IGNORE 或 ON CONFLICT DO NOTHING 在发生冲突时未插入 → 返回 0（Dapper 能如实反映这一行为）

不等于“执行是否成功”

Execute 不抛异常 ≠ 操作成功；返回 0 ≠ 一定出错。它只管“行数”，异常由底层 ADO.NET 抛出（比如连接失败、语法错误、违反约束等）。所以：

• 返回 0 是完全合法的业务结果（如更新一个不存在的用户）
• 返回大于 0 也不代表业务逻辑正确（比如误删了多条）
• 需要结合业务语义判断：比如“新增用户”期望返回 1，若得 0 就该提示“用户名已存在”

和 Insert/Update/Delete 场景的对应关系

不同操作下返回值的典型含义：

• INSERT：通常为 1（单条）或 N（批量），但含唯一键冲突时可能为 0（取决于 SQL 写法，如用 INSERT IGNORE 或 ON CONFLICT）
• UPDATE：等于 WHERE 条件命中的行数，哪怕 SET 的值和原值一样（SQL Server 默认如此；MySQL 可配置是否严格检测变更）
• DELETE：等于被删除的行数，可为 0（无匹配）到任意正整数
• 存储过程调用：默认返回的是过程内最后一条可影响行数的语句的结果；如需获取 RETURN_VALUE，必须显式用 DynamicParameters 添加 ParameterDirection.ReturnValue 参数

常见误区提醒

几个容易混淆的点：

• ❌ 不是自增主键值 —— 想取新 ID 请用 ExecuteScalar 配合 OUTPUT INSERTED.Id 或 SELECT SCOPE_IDENTITY()
• ❌ 不是执行耗时或状态码 —— 它纯粹是数据库返回的整数
• ❌ 不会因事务回滚而返回负数 —— 回滚后 Execute 已不返回，而是抛出异常或由上层捕获
• ✅ 支持批量操作 —— 传入 List 实体或匿名对象集合时，返回的是所有批次累计影响行数

基本上就这些。理解 “返回值 = 数据库说改了几行”，就能避开大多数误判。

# mysql  # app  # 状态码  # .net  # sql  # select  # int  # delete  # 对象  # postgresql  # 数据库  # 行数  # 的是  # 返回值  # 抛出  # 主键  # 几个  # 这一  # 也不  # 就能  # 不存在 

相关文章： 网站规划与制作是什么,电子商务网站系统规划的内容及步骤是什么？  如何快速搭建个人网站并优化SEO？  已有域名和空间如何快速搭建网站？  php能控制zigbee模块吗_php通过串口与cc2530 zigbee通信【介绍】  重庆网站制作公司哪家好,重庆中考招生办官方网站？  陕西网站制作公司有哪些,陕西凌云电器有限公司官网？  如何高效完成独享虚拟主机建站？  ,sp开头的版面叫什么？  如何高效完成自助建站业务培训？  PHP正则匹配日期和时间(时间戳转换)的实例代码  定制建站策划方案_专业建站与网站建设方案一站式指南  清除minerd进程的简单方法  黑客入侵网站服务器的常见手法有哪些？  Python lxml的etree和ElementTree有什么区别  网站图片在线制作软件,怎么在图片上做链接？  代购小票制作网站有哪些,购物小票的简要说明？  如何零基础开发自助建站系统？完整教程解析  建站之星代理商如何保障技术支持与售后服务？  建站之星2.7模板快速切换与批量管理功能操作指南  手机网站制作平台,手机靓号代理商怎么制作属于自己的手机靓号网站？  深入理解Android中的xmlns:tools属性  公众号网站制作网页,微信公众号怎么制作？  装修招标网站设计制作流程,装修招标流程？  太平洋网站制作公司,网络用语太平洋是什么意思？  ,想在网上投简历，哪几个网站比较好？  关于BootStrap modal 在IOS9中不能弹出的解决方法(IOS 9 bootstrap modal ios 9 noticework)  南平网站制作公司,2025年南平市事业单位报名时间？  免费制作海报的网站,哪位做平面的朋友告诉我用什么软件做海报比较好?ps还是cd还是ai这几个软件我都会些我是做网页的？  ,怎么用自己头像做动态表情包？  车管所网站制作流程,交警当场开简易程序处罚决定书，在交警网站查询不到怎么办？  如何选择网络建站服务器？高效建站必看指南  香港服务器租用每月最低只需15元？  建站之星好吗？新手能否轻松上手建站？  广德云建站网站建设方案与建站流程优化指南  如何通过老薛主机一键快速建站？  名字制作网站免费,所有小说网站的名字？  香港服务器网站搭建教程-电商部署、配置优化与安全稳定指南  宿州网站制作公司兴策,安徽省低保查询网站？  如何通过NAT技术实现内网高效建站？  网站制作软件免费下载安装,有哪些免费下载的软件网站？  如何做网站制作流程,*游戏网站怎么搭建？  建站主机选虚拟主机还是云服务器更好？  如何在沈阳梯子盘古建站优化SEO排名与功能模块？  如何快速生成专业多端适配建站电话？  如何高效配置香港服务器实现快速建站？  深圳网站制作设计招聘,关于服装设计的流行趋势，哪里的资料比较全面？  建站之星各版本价格是多少？  制作证书网站有哪些,全国城建培训中心证书查询官网？  如何快速搭建高效简练网站？  C#如何序列化对象为XML XmlSerializer用法