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  # 数据库  # 行数  # 的是  # 返回值  # 抛出  # 主键  # 几个  # 这一  # 也不  # 就能  # 不存在 

相关文章： 招商网站制作流程,网站招商广告语？  微信小程序制作网站有哪些,微信小程序需要做网站吗？  文字头像制作网站推荐软件,醒图能自动配文字吗？  外贸公司网站制作,外贸网站建设一般有哪些步骤？  制作充值网站的软件,做人力招聘为什么要自己交端口钱？  小视频制作网站有哪些,有什么看国内小视频的网站，求推荐？  如何快速建站并高效导出源代码？  如何在阿里云通过域名搭建网站？  如何在阿里云购买域名并搭建网站？  如何确保FTP站点访问权限与数据传输安全？  如何通过多用户协作模板快速搭建高效企业网站？  建站之星免费模板：自助建站系统与智能响应式一键生成  大连网站设计制作招聘信息,大连投诉网站有哪些？  php能控制zigbee模块吗_php通过串口与cc2530 zigbee通信【介绍】  如何快速搭建高效香港服务器网站？  高端企业智能建站程序：SEO优化与响应式模板定制开发  免费ppt制作网站,有没有值得推荐的免费PPT网站？  如何用手机制作网站和网页,手机移动端的网站能制作成中英双语的吗？  如何使用Golang table-driven基准测试_多组数据测量函数效率  如何零基础开发自助建站系统？完整教程解析  广州商城建站系统开发成本与周期如何控制？  如何通过商城自助建站源码实现零基础高效建站？  香港服务器租用费用高吗？如何避免常见误区？  如何通过虚拟主机空间快速建站？  如何快速生成凡客建站的专业级图册？  广州网站建站公司选择指南：建站流程与SEO优化关键词解析  焦点电影公司作品,电影焦点结局是什么？  建站一年半SEO优化实战指南：核心词挖掘与长尾流量提升策略  在线制作视频的网站有哪些,电脑如何制作视频短片？  建站之星在线版空间：自助建站+智能模板一键生成方案  网站企业制作流程,用什么语言做企业网站比较好？  GML (Geography Markup Language)是什么，它如何用XML来表示地理空间信息？  如何制作一个表白网站视频,关于勇敢表白的小标题？  设计网站制作公司有哪些,制作网页教程？  XML的“混合内容”是什么 怎么用DTD或XSD定义  电脑免费海报制作网站推荐,招聘海报哪个网站多？  ,有什么在线背英语单词效率比较高的网站？  活动邀请函制作网站有哪些,活动邀请函文案？  宁波免费建站如何选择可靠模板与平台？  重庆市网站制作公司,重庆招聘网站哪个好？  香港服务器选型指南：免备案配置与高效建站方案解析  如何高效完成自助建站业务培训？  定制建站价位费用解析与套餐推荐全攻略  大同网页,大同瑞慈医院官网？  打鱼网站制作软件,波克捕鱼官方号怎么注册？  昆明高端网站制作公司,昆明公租房申请网上登录入口？  建站org新手必看：2024最新搭建流程与模板选择技巧  临沂网站制作公司有哪些,临沂第四中学官网？  如何选择可靠的免备案建站服务器？  济南专业网站制作公司,济南信息工程学校怎么样？